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Production Note 


This book was produced with the VAX DOCUMENT electronic publishing 
system, a software tool developed and sold by Digital. In this system, 
writers use an ASCII text editor to create source files containing text and 
English-like code; this code labels the structural elements of the document, 
such as chapters, paragraphs, and tables. The VAX DOCUMENT software, 
which runs on the VMS operating system, interprets the code to format 
the text, generate a table of contents and index, and paginate the entire 
document. Writers can print the document on the terminal or line printer, 
or they can use Digital-supported devices, such as the LN03 laser printer 
and PostScript printers (PrintServer 40 or LN03R ScriptPrinter), to 
produce a typeset-quality copy containing integrated graphics. 












1 Introduction 

The VMS General User Master Index is an edited compilation of the 
individual indexes for books in the VMS Version 5.4 General User Subkit. 

Each main entry in the VMS General User Master Index is followed by an 
abbreviated book title and a reference to the page where the topic appears 
in that book. For example, an entry in the master index might appear in 
the following way: 

Login command procedure • Files and Devices, 2-8; 

Command Procedures, 1-9 

T his entry indicates that you can find informatioh about login command 
procedures in the following places: 

• Page 2-8 in the Guide to VMS Files and Devices 

• Page 1-9 in the Guide to Using VMS Command Procedures 

The subentries, if any, contain more specific information about the topic. 
For example, some subentries listed under Login command procedure are 
as follows: 

alternate 

execution of for batch jobs 
system-defined 

The following table lists the abbreviated names used in the VMS General 
User Master Index to reference each manual, the volume number of 
the binder that contains the manual, and the full manual title that 
corresponds to the abbreviated name: 


Index Abbreviation 

Volume 

Title of Manual 

Command Procedures 

3 

Guide to Using VMS Command Procedures 

DCL Concepts 

3 

VMS DCL Concepts Manual 

DCL Dictionary 

4 1 

VMS DCL Dictionary 

DSR Ref 

5B 

VAX DIGITAL Standard Runoff Reference Manual 

EDT Ref 

5A 

VAX EDT Reference Manual 

EVE Ref 

5B 

VMS EVE Reference Manual 

Files and Devices 

2A 

Guide to VMS Files and Devices 

Mail 

2B 

VMS Mail Utility Manual 

Phone 

2B 

VMS Phone Utility Manual 

Sort/Merge 

2B 

VMS Sort/Merge Utility Manual 

Text Processing 

5A 

Guide to VMS Text Processing 

Using VMS 

2A 

Guide to Using VMS 

VMS Intro 

2A 

Introduction to VMS 


1 Page number prefix DCL1 indicates Volume 4A; DCL2 indicates Volume 4B 
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A 


@ command • EVE Ref, EVE-2, EVE-3 
Abbreviation 

in command procedures • DCL Concepts, 1-6 
of commands • DCL Concepts, 1-5 
of DSR commands • DSR Ref, 1-1, 1-4 
of EVE commands • Text Processing, 1-7 
of keywords • DCL Concepts, 1-12 
of qualifiers • DCL Concepts, 1-12 
Aborting operation 

in keypad mode • EDT Ref, EDT-32 
in line mode • EDT Ref, EDT-127 
in nokeypad mode • EDT Ref, EDT-272 
Absolute time 

combined with delta time • Using VMS, 1-16; 

DCL Concepts, 1-16 

default values • Using VMS, 1-15; DCL Concepts, 
1-14 

examples* Using VMS, 1-15; DCL Concepts, 
1-15 

rules for entering • Using VMS, 1-15; DCL 
Concepts, 1-14 

syntax • Using VMS, 1-15; DCL Concepts, 1-14 
Accept flag • DSR Ref, 3-5 
recognizing • DSR Ref, 2-41 
Access 

append operation • Files and Devices, 4-19 
CONTROL • Files and Devices, 2-9, 2-11, 2-12 
DELETE • Files and Devices, 2-9, 2-11, 2-12 
EXECUTE • Files and Devices, 2-9, 2-11 
file attributes • Files and Devices, 4-18 
object • Using VMS, 7-3 
READ • Files and Devices, 2-9, 2-11 
to file • Files and Devices, B-1 3 

on magnetic tape • Files and Devices, 4-16 
to volume 

on magnetic tape • Files and Devices, 4-16 
types of • Files and Devices, 2-2, 4-20 
update operation • Files and Devices, 4-19 
WRITE • Files and Devices, 2-9, 2-11 
Access category 

summary of • Files and Devices, 2-1 
Access control list 
See ACL 


Access Control List Editor 
See ACL Editor 
Access control list entry 
See ACE 

Access control string 

copying files between nodes with • Using VMS, 
2-16 

definition • Using VMS, 2-11; DCL Concepts, 3-2 
example • Using VMS, 2-11; DCL Concepts, 3-3 
format in a node name • DCL Concepts, 3-3 
in a logical node name • Using VMS, 4-16; DCL 
Concepts, 4-21 to 4-23 
rules for entering • Using VMS, 2-11; DCL 
Concepts, 3-3 

Accessibility field • Files and Devices, 2-12, B-9, 

B-13 

Accessing restricted files • DCL Dictionary, DCL2-236 
Access mode 

and the DEFINE command • Using VMS, 4-13; 

DCL Concepts, 1-8, 4-14 
for a logical name • Using VMS, 4-13; DCL 
Concepts, 4-14 

for a logical name table • Using VMS, 4-13; DCL 
Concepts, 4-17 

supervisor • Command Procedures, 2-4 

user • Command Procedures, 2-4 

using qualifiers to specify* Using VMS , 4-13; 

DCL Concepts, 1-8, 4-14, 4-17 
Access types 

See also CONTROL access 
See also DELETE access 
See also EXECUTE access 
See also READ access 
See also WRITE access 
CONTROL • Files and Devices, 2-2 
defined for a device • DCL Concepts, 8-6 
defined for a directory • DCL Concepts, 8-8 
defined for a file • DCL Concepts, 8-9 
defined for a global section • DCL Concepts, 8-10 
defined for a logical name table • DCL Concepts, 
8-10 

defined for a queue • DCL Concepts, 8-7 
defined for a volume • DCL Concepts, 8-7 
DELETE • Files and Devices, 2-2 
EXECUTE • Files and Devices, 2-2 
list of • DCL Concepts, 8-4 
READ • Files and Devices, 2-2 
WRITE • Files and Devices, 2-2 
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Account • VMS Intro, 1-1 
Accounting 

enabling or disabling logging • DCL Dictionary, 
DCL2-91 

of detached process • DCL Dictionary, DCL2-55 
of terminal session • DCL Dictionary, DCL2-303 
ACCOUNTING command* DCL Dictionary, DCL1-14 
See also SET ACCOUNTING command 
ACE (access control list entry) • Files and Devices, 
2-8, 2-9, 2-12 

ALARM_JOURNAL • Using VMS, 7-9 
creating • Using VMS, 7-7 
DEFAULT_PROTECTION • Using VMS, 7-9 
deleting • Using VMS, 7-14 
IDENTIFIER • Using VMS, 7-8 
processing • Using VMS, 7-18 
replacing • Using VMS, 7-14 
ACL (access control list) 
copying • Using VMS, 7-14 
default protection • Using VMS, 7-10; Files and 
Devices, 2-8 

defining with DCL • Files and Devices, 2-3 
definition • Using VMS, 7-1, 7-5 
description of • Files and Devices, 2-3 
displaying with SHOW ACL command • Using 
VMS, 7-12 

editing with EDIT/ACL command • Using VMS, 
7-15 

entries in • Using VMS, 7-7 
identifier • Using VMS, 7-6 
modifying • Using VMS, 7-14 
protecting files with • Using VMS, 7-5 
SHOW ACL command • Files and Devices, 2-13 
specifying with SET ACL command • Using VMS, 
7-13 

ACL (access control list) Editor 

deleting text with • Using VMS, 7-18 
invoking with EDIT/ACL command • Using VMS, 
7-15 

keypad • Using VMS, 7-15 
moving the cursor with • Using VMS, 7-17 
restoring text with • Using VMS, 7-18 
ACL-based protection • Files and Devices, 2-3 
See also ACL 

definition • DCL Concepts, 8-1 
Address sort* Using VMS, 1-39 

reasons for selecting • Sort/Merge, SORT-29 
specifying • Sort/Merge, SORT-70 
ADV (advance) command • EDT Ref, EDT-260 
See also Cursor direction 


ADVANCE • EDT Ref EDT-18 
See also Cursor direction 

ADVANCE (EDT keypad function) • Text Processing, 
2-10, 2-16 

ADVANCE command • Using VMS, 8-58 
ALARM_JOURNAL access control list entry • Using 
VMS, 7-9 

ACCESS field • Using VMS, 7-9 
Allocate access category 
definition • Using VMS, 7-4 
ALLOCATE command • Using VMS, 2-10; Files 
and Devices, 3-20; DCL Concepts, 3-6; DCL 
Dictionary, DCL1-15 to DCL1-17 

See also Allocation 

and DEASSIGN command • DCL Dictionary, 
DCL1-104 

and DISMOUNT command • DCL Dictionary, 
DCL1-170 

/GENERIC qualifier • Files and Devices, 3-2 
magnetic tape • Files and Devices, 4-15, 5-2 
Allocation 

of devices • DCL Dictionary, DCL1-15 
of disk drive • Files and Devices, 3-1 
generic • Files and Devices, 3-2, 3-3 
of disk volume • Files and Devices, 4-8, 4-9 
of magnetic tape drive • Files and Devices, 3-1 
of magnetic tape volume • Files and Devices, 4-15 
Allocation class field 

definition • DCL Concepts, 3-6 
/ALLOCATION qualifier • Sort/Merge, SORT-40 
/ALL qualifier 

with DELETE/KEY command • VMS Intro, 6-11 
with RECALL command • VMS Intro, 6-13 
with SHOW KEY command • VMS Intro, 6-11 
Ampersand (&) 

as a substitution operator • DCL Concepts, 7-3 to 
7-4 

requesting symbol substitution with • Command 
Procedures, 2-15 
Analysis 

dump file • DCL Dictionary, DCL1-30 
global symbol table • DCL Dictionary, DCL1-23 
image file* DCL Dictionary, DCL1-22 
image file fixup section • DCL Dictionary, DCL1-23 
image file patch text records • DCL Dictionary, 
DCL1-24 

object file • DCL Dictionary, DCL1-26 
debugger information records • DCL 
Dictionary, DCL1-27 
end-of-module records • DCL Dictionary, 
DCL1-27 
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Analysis 

object file (Cont.) 

global symbol directory records • DCL 
Dictionary, DCL1-27 
link option specification records • DCL 
Dictionary, DCL1-28 
module header records • DCL Dictionary, 
DCL1-28 

module traceback records • DCL Dictionary, 
DCL1-28 

relocation records* DCL Dictionary, DCL1-29 
text -DCL Dictionary, DCL1-29 
object module* DCL Dictionary, DCL1-26 
patch text record • DCL Dictionary, DCL1-24 
shareable image file • DCL Dictionary, DCL1-22 
Analysis back-end converter • DCL Dictionary, 
DCL1-70 

ANALYZE/AUDIT command • DCL Dictionary, 
DCL1-18 

ANALYZE/CRASH_DUMP command • DCL 
Dictionary, DCL1-19 

ANALYZE/DISK_STRUCTURE command • DCL 
Dictionary, DCL1-20 

ANALYZE/ERROR_LOG command • DCL Dictionary, 
DCL1-21 

ANALYZE/IMAGE command • DCL Dictionary, 
DCL1-22 to DCL1-24 

ANALYZE/MEDIA command • DCL Dictionary, 
DCL1-25 

ANALYZE/OBJECT command • DCL Dictionary, 
DCL1-26 to DCL1-29 

ANALYZE/PROCESS_DUMP command • DCL 
Dictionary, DCL1-30 to DCL1-31 
ANALYZE/RMS_FILE command • DCL Dictionary, 
DCL1-32 

ANALYZE/SYSTEM command • DCL Dictionary, 
DCL1-33 
.AND. 

in a logical operation • DCL Concepts, 6-8 
Annotated command procedures • Command 
Procedures, A-1 to A-29 
ANSI data • Files and Devices, B-1 
ANSI file name • Files and Devices, 4-18, B-10 
ANSI-labeled magnetic tape volume 

file specification format • DCL Concepts, 3-16 
mounting • Files and Devices, 3-12 
ANSI-labeled volume • Files and Devices, B-1, B-3 
accessibility protection • Files and Devices, 2-4 
copying files from • Files and Devices, 5-3 
format • Files and Devices, B-1 
ANSI standard • Files and Devices, B-1 

structure of magnetic tape • Files and Devices, 
1-6 


ANSWER command • Mail, MAIL-26 
See also REPLY command 
ANSWER command (PHONE)* VMS Intro, 1-15 
Answering a call • Phone, PHONE-9 
Apostrophe (’) 

as a substitution operator • DCL Concepts, 7-2 
requesting symbol substitution with • Command 
Procedures, 2-14 

Append access • Files and Devices, 4-19 
APPEND command • VMS Intro, 6-6; DCL 

Dictionary, DCL1-34 to DCL1-38; EDT Ref, 
EDT-20, EDT-261 
See also Moving text 

using with DECwindows compound documents • 
DCL Dictionary, DCL1-34 
Appendix 

creating with DSR • Text Processing, 3-36; DSR 
Ref, 2-2 

DSR example • DSR Ref, 2-16 
DSR header formats • DSR Ref, 2-16, 2-87 
formatting with DSR • DSR Ref, A-3 
.APPENDIX command • Using VMS, 9-14; DSR Ref, 
2-2 

APPEND key 

EDT • Text Processing, 2-19 
APPEND qualifier (OPEN command) • Command 
Procedures, 6-9 
Applications 

running locally* DCL Dictionary, DCL2-133 
running remotely • DCL Dictionary, DCL2-133 
/APPLICATION_KEYPAD qualifier* VMS Intro, 6-15 
Arguments 

default • DSR Ref, 1-2 
definition of • DSR Ref, 1-2 
null • DSR Ref, 1-4 
optional • DSR Ref, 1-2 
rules for separating • DSR Ref, 1-4 
Arrow keys • EDT Ref, EDT-2 

See also DOWN arrow key, LEFT arrow key, 
RIGHT arrow key, UP arrow key 
to move the cursor • DCL Concepts, 2-5 
to recall commands • DCL Concepts, 2-6 
ASC (ASCII) • EDT Ref, EDT-262 
ASCII 

collating sequence • Using VMS, 1-39 
ASCII “a” character set* Files and Devices, 5-3, 
B-1, B-3; DCL Concepts, 3-16 
percent sign • Files and Devices, 4-18 
ASCII character set • Using VMS, A-1; DCL 
Concepts, B-1 

ASCII control characters • EDT Ref, EDT-262, A-1 
Assembler • VMS Intro, 4—2 
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Assembly language • VMS Intro, 4-2 
ASSIGN command • VMS Intro, 3-9; Using VMS, 
4-2; Command Procedures, 2-2; DCL 
Dictionary, DCL1-39 to DCL1-45 

See also DEFINE command 
and DEASSIGN command • DCL Dictionary, 
DCL1-104 

function • DCL Concepts, 4-2 
how it handles a colon in a logical name • DCL 
Concepts, 4-2 

Assigning work files • Sort/Merge, SORT-7, SORT-72 
Assignment 

of logical queue to an execution queue • DCL 
Dictionary, DCL1-47 

of queue name • DCL Dictionary, DCL1-249 
of symbols interactively • DCL Dictionary, 
DCL1-262 

Assignment statement 

creating a blank line • Using VMS, 5-17; DCL 
Concepts, 6-4 

creating a global symbol • Using VMS, 5-3; DCL 
Concepts, 5-3 

creating a local symbol • Using VMS, 5-3; DCL 
Concepts, 5-3 

formatting output records • Using VMS, 5-17; 

DCL Concepts, 6-4 
for numeric overlay • Using VMS, 5-17 
including an asterisk • Using VMS, 5-4; DCL 
Concepts, 5-4 

including a symbol as part of a character string • 
Using VMS, 5-11; DCL Concepts, 5-7 
syntax • Using VMS, 5-2; DCL Concepts, 5-2 
for numeric overlay • Using VMS, 5-16 
for string overlay • Using VMS, 5-16 
syntax for numeric overlay • DCL Concepts, 6-9 
syntax for string overlay • DCL Concepts, 6-3 
= (assignment statement) command • DCL Dictionary, 
DCL1-1 to DCL1-4 

ASSIGN/MERGE command • DCL Dictionary, 
DCL1-46 

ASSIGN/QUEUE command • DCL Dictionary, 
DCL1-47 to DCL1—48 
and DEASSIGN/QUEUE command • DCL 
Dictionary, DCL1-109 
AST (asynchronous system trap) 

specifying quota • DCL Dictionary, DCL2-55 
Asterisk (*) 

wildcard • Files and Devices, 4-17 

in directory specifications* Using VMS, 2-14; 
DCL Concepts, 3-18 

in input file specifications • DCL Concepts, 
3-18 


Asterisk (*) 

wildcard (Cont.) 

in output directory specifications • DCL 
Concepts, 3-20 

in output file specification • DCL Concepts, 
3—19 

in UIC format directory specifications • DCL 
Concepts, 3-18 

rules for using • Using VMS, 2-14; DCL 
Concepts, 3-18 

used to rename files • DCL Concepts, 3-19 
ATTACH command • Using VMS, 1-21, 3-6; 

Mail, MAIL-28; DCL Dictionary, DCL1-49 
to DCL1-50; EVE Ref, EVE-4 to EVE-5 
EVE editor* Text Processing, 1-68 
restriction on using (EVE) • Text Processing, 1-67 
Attached processor 

showing state • DCL Dictionary, DCL2-258 
starting • DCL Dictionary, DCL2-343 
stopping • DCL Dictionary, DCL2-361 
Attributes 

buffer-specific (EVE)* Text Processing, 1-71 
global (EVE)* Text Processing, 1-71,1-72 
listed by startup file (EVE) • Text Processing, 1-74 
SAVE ATTRIBUTES command • EVE Ref, 

EVE-134 

SAVE SYSTEM ATTRIBUTES command • EVE 

Ref, EVE-141 

saving • EVE Ref, 1-2, 1-33 

saving in EVE command file • Text Processing, 

1-77; EVE Ref, 1-37 

saving in EVE section file • Text Processing, 1-73; 

EVE Ref, 1-35 

saving system defaults* EVE Ref, 1-38 
setting (EVE) • Text Processing, 1-71 
Authorize Utility (AUTHORIZE) • Using VMS, 7-1 
.AUTOJUSTIFY command • DSR Ref, 2-3 
Automatic login • Using VMS, 1-3 
.AUTOPARAGRAPH command ♦ DSR Ref, 2-4 
example • DSR Ref, 2-4 
.AUTOSUBTITLE command • DSR Ref, 2-6 
.AUTOTABLE command • DSR Ref, 2-7 
example • DSR Ref, 2-7 


B 


BACK command • Mail, MAIL-30; EDT Ref, 
EDT-263 

See also Cursor direction 
Back-end converter 

analysis • DCL Dictionary, DCL1-70 
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Back-end converter (Cont.) 

PostScript • DCL Dictionary, DCL1-68 
text • DCL Dictionary, DCL1-67 
BACKSPACE • EDT Ref, EDT-22 
See also Cursor movement 
BACKSPACE key'Using VMS, 1-18; DCL 
Concepts, 2-5 

/BACKSPACE qualifier • DSR Ref, 4-5 
BACKUP (EDT keypad function) • Text Processing, 
2-10,2-16; EDT Ref, EDT-23 
See also Cursor direction 
BACKUP.SYS • Files and Devices, A-3 
BACKUP command • Using VMS, 8-58; DCL 
Dictionary, DCL1-51 
Backup log file • Files and Devices, A-3 
Backup operations • Files and Devices, 1-8 
BADBLK.SYS • Files and Devices, A-2 
Bad block data 

on disks • DCL Dictionary, DCL1-247 
Bad block file • Files and Devices, A-2 
BADLOG.SYS • Files and Devices, A-3 
Base address 

defining for images • DCL Dictionary, DCL1-390 
Base priority 

establishing for batch job • DCL Dictionary, 
DCL1-252, DCL2-203 
Batch editing • EVE Ref, 1-10 

EVE*DCL Dictionary, DCL1-191, DCL1-194 
VAXTPU • DCL Dictionary, DCL1-191, DCL1-194 
Batch execution of command procedure • Command 
Procedures, 1-6 
Batch job • VMS Intro, 5-10 

accessing devices • Files and Devices, 3-21 
defining default working set • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 

defining maximum CPU time limit • DCL Dictionary, 
DCL1-267 

defining working set extent • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 
defining working set quota • DCL Dictionary, 
DCL1-269, DCL2-208, DCL2-353, 
DCL2-383 

definition • VMS Intro, 1-1, 6-3; Using VMS, 3-8 
deleting • Command Procedures, 8-8 
deleting files 

after processing • DCL Dictionary, DCL2-379 
deleting log file* DCL Dictionary, DCL1-267, 
DCL2-380 

end of job on cards • DCL Dictionary, DCL1—208 
flushing output buffer • DCL Dictionary, DCL2-183 


Batch job (Cont.) 

holding • DCL Dictionary, DCL1—267, DCL2—380 
job number of • Using VMS, 3-8 
keeping log file • DCL Dictionary, DCL2—380 
limiting CPU time of • DCL Dictionary, DCL1-267, 
DCL2-380 

log file • Using VMS, 3-9; DCL Dictionary, 
DCL2-376 

on remote network node • DCL Dictionary, 
DCL2-382 

output • Using VMS, 3-9 

passing parameters to • Using VMS, 6-7, 6-8; 

DCL Dictionary, DCL2-381 
password • DCL Dictionary, DCL2—9 
priority • DCL Dictionary, DCL2-382 
providing input to • Command Procedures, 8-4 
queue 

changing entry* DCL Dictionary, DCL2-136 
displaying entries • DCL Dictionary, 
DCL2-275, DCL2-309 
entering command procedure in • DCL 
Dictionary, DCL2-376 

modifying characteristics of • DCL Dictionary, 
DCL2-345 

starting • DCL Dictionary, DCL2-345 
restarting • Using VMS, 3-9, 6-32; Command 
Procedures, 8-9 

saving log file • DCL Dictionary, DCL1—267 
specifying a queue • Command Procedures, 8—3 
starting • VMS Intro, 6-3 
stopping • Command Procedures, 8-8 
stopping process • DCL Dictionary, DCL2-358 
submitting • Using VMS, 3-8 
submitting command procedure as • Using VMS, 
1-6, 3-4; Command Procedures, 8-1 
submitting program as • Using VMS, 1-6 
submitting sort operation as • Using VMS, 1-41 
submitting through cards • DCL Dictionary, 
DCL1-266 

synchronizing multiple procedures • Command 
Procedures, 8-10 

synchronizing with process • DCL Dictionary, 
DCL2-387 

uses of • Command Procedures, 8-1 
working set 

defining default* DCL Dictionary, DCL1-260, 
DCL1-269, DCL2-208, DCL2-353, 
DCL2-383 

defining extent for • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 
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Batch job 

working set (Cont.) 

defining quota for • DCL Dictionary, 
DCL1-269, DCL2-208, DCL2-353, 
DCL2-383 

Batch job log file • Command Procedures, 8-5 
Batch mode 

definition • Using VMS, 1-6 
Batch-oriented editor* DCL Dictionary, DCL1-185 
Batch queue 

creating • DCL Dictionary, DCL1-249 
defining default CPU time limit • DCL Dictionary, 
DCL1-253, DCL2-204, DCL2-347 
defining default working set • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 

defining maximum CPU time limit • DCL Dictionary, 
DCL1-253, DCL2-205, DCL2-348 
defining working set extent • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 
defining working set quota • DCL Dictionary, 
DCL1-269, DCL2-208, DCL2-353, 

DCL2-383 

deleting • DCL Dictionary, DCL1-143 
deleting entries • DCL Dictionary, DCL1-136 
establishing base priority for jobs • DCL Dictionary, 
DCL1-252, DCL2-203 
initializing • DCL Dictionary, DCL1-249 
.BEGIN BAR command • DSR Ref, 2-26 
example • DSR Ref, 2-26 
Beginning-of-tape marker 
See BOT marker 

BELL command • EDT Ref, EDT-264 
Binary data • Files and Devices, B-1 
Binary files • DSR Ref, 4-14 
Bit 

definition • Using VMS, 5-1 
8-bit characters • DSR Ref, 2-14 
Bit map 

index file • Files and Devices, A-2 
storage • Files and Devices, A-2 
BITMAP.SVS • Files and Devices, A-2 
Bit operation 

examples • DCL Concepts, 6-8 to 6-9 
rules • DCL Concepts, 6-8 to 6-9 
BIX file • DSR Ref, 6-6 

.BLANK command • Text Processing, 3-3, 3-12, 
3-22,3-26; DSR Ref, 2-9 
Block 

specifying cluster size on disk • DCL Dictionary, 
DCL1-242 


Block allocation 

specifying • Sort/Merge, SORT-40 
Blocked record • Files and Devices, B-13 
Block length (BLN) field • Files and Devices, B-14 
Block size 

for files • DCL Dictionary, DCL1-164 
for magnetic tape 

default • Sort/Merge, SORT-43 
restrictions • Sort/Merge, SORT-43 
Boldfacing text 

with DSR • Text Processing, 3-46 
Bold flag • DSR Ref, 3-6 
default • DSR Ref, 3-6 
pairing • DSR Ref, 3-6 
recognizing • DSR Ref, 2-43 
Bolding • DSR Ref, 2-29 
See also Emphasizing text 
example • DSR Ref, 3-6 
/BOLD qualifier • DSR Ref, 4-6, 5-3 
Bootstrap block • Files and Devices, 1-5, A-1 
BOT (beginning-of-tape) marker • Files and Devices, 
B—2 

BOTTOM command • Using VMS, 8-9, 8-57; EVE 
Ref, EVE-6 

moving the cursor with (EVE) • Text Processing, 
1—8 

BOTTOM keypad function • EDT Ref, EDT-24 
See also Cursor positioning 
EDT • Text Processing, 2-10 
Bottom specifier 

with SET CURSOR • EDT Ref, EDT-175 
Bound cursor movement 

with EDT keypad • EVE Ref, EVE-172 
with the MOVE DOWN command • EVE Ref, 
EVE-87 

with the MOVE LEFT command • EVE Ref, 
EVE-88 

with the MOVE RIGHT command • EVE Ref, 
EVE-89 

with the MOVE UP command • EVE Ref, EVE-90 
with WPS keypad • EVE Ref, EVE-186 
BOX COPY command • EVE Ref, EVE-7 
EVE editor* Text Processing, 1-22 
using with search string (EVE) • Text Processing, 
1-20 

BOX CUT command • EVE Ref, EVE-8 to EVE-10 
EVE editor* Text Processing, 1-22 
using with search string (EVE) • Text Processing, 
1-20 

BOX CUT INSERT command • EVE Ref, EVE-11 to 
EVE-12 

EVE editor* Text Processing, 1-22 
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BOX CUT OVERSTRIKE command • EVE Ref, 
EVE-13 

EVE editor* Text Processing, 1-22 
Box editing 

EVE editor • Text Processing, 1-22 
BOX PASTE command • EVE Ref, EVE-14 to 
EVE-15 

EVE editor* Text Processing, 1-22 
BOX PASTE INSERT command • EVE Ref, EVE-16 
EVE editor* Text Processing, 1-22 
BOX PASTE OVERSTRIKE command • EVE Ref, 
EVE-17 

EVE editor • Text Processing, 1-22 
BOX SELECT command • EVE Ref, EVE-18 to 
EVE-20 

EVE editor* Text Processing, 1-22 
.BREAK command • Text Processing, 3-12; DSR 
Ref, 2-10 

Break flag • DSR Ref, 3-7 
default • DSR Ref, 3-7 
recognizing • DSR Ref, 2-44 
/BRIEF qualifier • EDT Ref, EDT-119 
with SUBSTITUTE • EDT Ref, EDT-243 
with TYPE • EDT Ref, EDT-251 
BRN file • DSR Ref, 5-1, 5-2, 6-6 

with DSR • Text Processing, 3-48, 3-53 
BTC file • DSR Ref, 5-1, 5-2 
/BUCKET_SIZE qualifier • Sort/Merge, SORT-41 
Buffer 

choosing from buffer list (EVE) • Text Processing, 
1-51 
creating 

with EDT • Text Processing, 2-35 
with EVE command NEW • EVE Ref, EVE-91 
definition • Using VMS, 8-2 
EVE • Text Processing, 1-2 
deleting 

with EDT • Text Processing, 2-35 
with EVE* Text Processing, 1-49, 1-51; 

EVE Ref, EVE-40 
displaying 

with EDT • Text Processing, 2-34 
with EVE • Text Processing, 1-51 
displaying list of system buffers (EVE) • Text 
Processing, 1-51 

editing multiple buffers (EVE) • Text Processing, 
1-52 

editing two buffers with two files (EVE) • Text 
Processing, 1-56 

EDT commands for using • Using VMS, 8-69 
EVE commands for using • Using VMS, 8-31 to 
8-33 


Buffer (Cont.) 

in EVE editor • Text Processing, 1-1 
listing 

with EVE • Text Processing, 1—51 
MAIN • Using VMS, 8-69 
PASTE • Using VMS, 8-66 
reading file into 

with EDT • Using VMS, 8-69 
with EVE-Using VMS, 8-34 
saving contents of • EVE Ref, EVE-250 
writing 

with EDT • Using VMS, 8-69 
with EVE • Using VMS, 8-34 
Buffer-1 specifier 

with MOVE • EDT Ref, EDT—150 
Buffer-2 specifier 

with MOVE • EDT Ref, EDT-150 
Buffer-change journaling • EVE Ref, 1-2, 1-12, 1-19, 
1-20 

EVE editor* Text Processing, 1-36 
BUFFER command • Using VMS, 8-9, 8-31; EVE 
Ref, EVE-21 to EVE-22 
changing buffers using (EVE) • Text Processing, 
1-53 

creating a new buffer with (EVE) • Text Processing, 
1-52 

displaying contents of Messages buffer (EVE) • 
Text Processing, 1-52 

for buffer manipulation (EVE) • Text Processing, 
1—47 

putting specific buffer into current window (EVE) • 
Text Processing, 1-52 
writing buffer to a file using (EVE) • Text 
Processing, 1-54 
Buffer List buffer 

displaying (EVE) • Text Processing, 1-51 
in EVE editor* Text Processing, 1-51 
selecting a buffer from (EVE) • Text Processing, 
1-51 

using REMOVE command (EVE) • Text 
Processing, 1-48 

using SELECT command (EVE) • Text Processing, 
1-48 

Buffer-offset length field • Files and Devices, B-15 
Buffer-specific attributes 
See also Initialization file 
EVE editor* Text Processing, 1-71,1-78 
Buffer specifier 
equal sign (=) 

in line mode • EDT Ref, EDT-120 
in nokeypad mode • EDT Ref, EDT-265 
in line mode* EDT Ref, EDT-120 
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Buffer specifier (Cont.) 

with <null> • EDT Ref, EDT-154 
with APPEND • EDT Ref EDT-261 
with CHANGE • EDT Ref EDT-122 
with CLEAR • EDT Ref EDT-124 
with CUT • EDT Ref EDT-275 
with DELETE • EDT Ref EDT-135 
with FILL • EDT Ref EDT-141 
with FIND • EDT Ref EDT-143 
with INCLUDE • EDT Ref EDT-147 
with INSERT • EDT Ref EDT-148 
with PASTE • EDT Ref EDT-298 
with PRINT • EDT Ref EDT-157 
with REPLACE • EDT Ref EDT-165 
with RESEQUENCE • EDT Ref EDT-167 
with SUBSTITUTE • EDT Ref EDT-243 
with TAB ADJUST* EDT Ref EDT-249 
with TYPE • EDT Ref EDT-251 
with WRITE • EDT Ref EDT-253 
Built-in command 

definition • Using VMS, 1-6; DCL Concepts, 1-1 
interrupting and canceling • Using VMS, 1-20 to 
1-21; DCL Concepts, 2-2 
table of DCL* Using VMS, 1-7; DCL Concepts, 
1-2 

Bulleted list 
See List 

BYPASS privilege • DCL Concepts, 8-6 
Byte 

definition • Using VMS, 5-1 
Byte dump* DCL Dictionary, DCL1-175 


c 


CALL command • Using VMS, 6-26; DCL Dictionary, 
DCL1-52 to DCL1-55 

CANCEL command • DCL Dictionary, DCL1—56 to 
DCL1-57 
Cancellation 

of detached process wakeup request • DCL 
Dictionary, DCL2-55 

of logical name assignments • DCL Dictionary, 
DCL1-104 

of subprocess wakeup request • DCL Dictionary, 
DCL2-55 

Capitalization • DSR Ref 2-45 
See also Changing case 
CAPITALIZE command ♦ Using VMS, 8-30 
EVE editor* Text Processing, 1-46 


Capitalize flag • DSR Ref 3-8 
default • DSR Ref 3-8 
recognizing • DSR Ref 2-45 
CAPITALIZE WORD command • Using VMS, 8-36; 
EVE Ref EVE-23 

formatting text with (EVE) • Text Processing, 1-39 
using with search string (EVE) • Text Processing, 
1-20 

Card 

submitting batch job on • DCL Dictionary, 
DCL1-266 
Card reader 

end of batch job • DCL Dictionary, DCL1-208 
Carriage control 

types of • Using VMS, 2-5 
Carriage return 

keypad mode • EDT Ref EDT-42, EDT-90 
Case control flags 

capitalize flag • DSR Ref 3-8 
lowercase flag • DSR Ref 3-13 
uppercase flag • DSR Ref 3-20 
Case-exact search • EVE Ref 1-2 
Case sensitivity 

search strings (EVE) • Text Processing, 1-27 
with REPLACE command (EVE) • Text Processing, 
1-34 

/CDD_PATH_NAME qualifier • Sort/Merge, SORT-50 
.CENTER command • Text Processing, 3-3; DSR 
Ref 2-11 

CENTER LINE command • Using VMS, 8-30, 8-36; 
EVE Ref EVE-24 
EVE editor* Text Processing, 1-46 
formatting text with (EVE) • Text Processing, 1-39 
Change bars • DSR Ref 2-26, 4-7 
CHANGE command • Using VMS, 8-52; EDT Ref 
EDT-122 

CHANGE DIRECTION command • EVE Ref EVE-25 
to EVE-26 

moving the cursor with (EVE) • Text Processing, 
1—8 

Change Direction key 

EVE editor* Text Processing, 1-30 
CHANGE MODE command • EVE Ref EVE-27 to 
EVE-28 

EVE editor* Text Processing, 1-12 
/CHANGE_BARS qualifier • DSR Ref 4-7 
Changing case 

keypad mode • EDT Ref EDT-26 
lower • DSR Ref 2-50, 3-13 
nokeypad mode • EDT Ref EDT-266, EDT-267, 
EDT-268 

upper • DSR Ref 2-57, 3-8, 3-20 


Index-8 









Index 


Chapter 

formatting • DSR Ref, A-3 
example • DSR Ref, 2-18 
header • DSR Ref, 2-18 
numbering • DSR Ref, 2-13, 2-88 
.CHAPTER command • Using VMS, 9-14; DSR Ref, 
2-13 

Chapter format (DSR) • Text Processing, 3-33 
Chapter number 

letter (DSR) • Text Processing, 3-33 
Roman numeral (DSR) • Text Processing, 3-33 
CHAR • EDT Ref, EDT-25 
See also Cursor movement 
Character 

decimal value • EDT Ref, A-1 
Character data 

See also Character string 
alphanumeric • Using VMS, 5-7 
expression • Using VMS, 5-12 
nonprintable • Using VMS, 5-8 
special • Using VMS, 5-8 
Characters 

literal translation of • DSR Ref, 2-41 
Character set • EDT Ref, A-1 
See also SPECINS 
ASCII • Using VMS, A-1 
DEC Multinational • Using VMS, A-5 
Character specifier 

with circumflex ( A ) • EDT Ref, EDT-269 
Character string • Using VMS, 5-7 
See also String 

comparison operators in expression • Using VMS, 
5-11 

concatenation • Using VMS, 5-12 
creating • Using VMS, 5-8 
evaluation of • Using VMS, 5-3 
expression • Using VMS, 5-12 
finding in file • DCL Dictionary, DCL2-81 
multiple string values in an expression • Using 
VMS, 5-12 

passing to command procedure • Using VMS, 6-7 
reduction • Using VMS, 5-12 
specifying case for search • DCL Dictionary, 
DCL2-81 

substring replacement in • Using VMS, 5—16 
symbol assignment • DCL Dictionary, DCL1-5 
symbol substitution in • Using VMS, 5-6 
used as symbol • Using VMS, 5-2 
values stored in • Using VMS, 5-7 
Character symbol • EDT Ref, A-1 
CHAR command • Using VMS, 8-54, 8-63 


CHAR keypad function 

EDT • Text Processing, 2-11 
/CHECK_SEQUENCE qualifier • Sort/Merge, 
SORT-12, SORT-51 
CHNGCASE keypad function 
EDT • Text Processing, 2-21 
$CHOICES$ buffer • EVE Ref, EVE-43 
with input files • EVE Ref, 1-6 
with journal files • EVE Ref, 1-22 
with NEXT WINDOW command • EVE Ref, 
EVE-94 

with PREVIOUS WINDOW command • EVE Ref, 
EVE-104 

with RESET command • EVE Ref, EVE-122 
Choices buffer 

with journal files (EVE) • Text Processing, 1-38 
Circumflex ( A ) • EDT Ref, EDT-269 
CLEAR command • EDT Ref, EDT-124 
CLEAR MAIN command 

EDT editor • Text Processing, 2-35 
Clear search string 
See CLSS 
Clipboard 

See SET CLIPBOARD command 
commands and keys affected • EVE Ref, EVE-152 
CLOSE command • Using VMS, 6-14; Command 
Procedures, 6—1; DCL Dictionary, DCL1 -58 to 
DCL1-59 

See also OPEN command 
Close operation • Files and Devices, 4-19, 4-20 
CLSS (clear search string) command • EDT Ref, 
EDT-270 

See also Locating text 
Cluster 

dismounting volumes on • DCL Dictionary, 
DCL1-171 

Cluster device name 

allocation class field • DCL Concepts, 3-6 
cluster node field • DCL Concepts, 3-6 
format for dual-pathed device • DCL Concepts, 

3—6 

format in a file specification • DCL Concepts, 3-6 
Cluster node field 

definition • DCL Concepts, 3-6 
Cluster size 

specifying on disk* DCL Dictionary, DCL1-242 
Clusterwide device 

dismounting • DCL Dictionary, DCL1-171 
Code generated for saving attributes • EVE Ref, 1-37 
Collating sequence • Sort/Merge, SORT-4 

ASCII • Using VMS, 1-39; Sort/Merge, SORT-4, 
SORT-13, SORT-54 
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Collating sequence 
ASCII (Cont.) 

table of •Sort/Merge, SORT-14 
default • Sort/Merge, SORT-4 
EBCDIC • Using VMS, 1-39; Sort/Merge, 
SORT-4, SORT-13, SORT-54 
folding • Sort/Merge, SORT-55 
ignoring characters in • Sort/Merge, SORT-54 
modifying • Sort/Merge, SORT-53, SORT-54 
MULTINATIONAL • Using VMS, 1-40; 

Sort/Merge, SORT-4, SORT-13, SORT-54 
table of • Sort/Merge, SORT-14 
restriction 

in user-defined • Sort/Merge, SORT-53 
specifying • Sort/Merge, SORT-54 
/COLLATING_SEQUENCE qualifier •Sort/Merge, 
SORT-13, SORT-52 
Column format 

EDT • Text Processing, 2-37 
Combination time • Using VMS, 1-16 
examples • DCL Concepts, 1-17 
rules for entering • DCL Concepts, 1-16 
syntax • DCL Concepts, 1-16 
Command 

See also Command procedure 

See also Foreign command 

abbreviating • Using VMS, 1-10; DCL Concepts, 

1- 5; DSR Ref, 1-4 

in command procedures • Using VMS, 1-10 
in HELP • Using VMS, 1-7 
built-in • Using VMS, 1-6 

See also Built-in command 
canceling • Using VMS, 1-11, 1-20, 1-21; DCL 
Concepts, 1-4, 2-1 
conditional • DSR Ref, 4-8 
continuing to a second line • Command 
Procedures, 1-3 

DCL syntax line • Using VMS, 1-8; DCL 
Concepts, 1-3 
DSR • DSR Ref, 1-1 

executing • Using VMS, 1-19; DCL Concepts, 

2 - 1 

format of • DSR Ref, 1-2 
in command procedures • Command Procedures, 
C—1 to C—3 

interrupting • Using VMS, 1-20 to 1-21; DCL 
Concepts, 2-1 to 2-3 
multiple on same line • DSR Ref, 1-3 
parts of • DSR Ref, 1-2 
rules for entering • Using VMS, 1-10; DCL 
Concepts, 1-3 

separating arguments • DSR Ref, 1-4 


Command (Cont.) 

syntax of • DSR Ref, 1-1 
terminating • DSR Ref, 1-3 
types • Using VMS, 1-6; DCL Concepts, 1-1 
COMMAND • EDT Ref, EDT-28 
Command arguments 
separating • DSR Ref, 1-4 
Command Definition Utility (CDU) 
invoking • DCL Dictionary, DCL2-117 
Command file • EVE Ref, 1-8 

creating (EVE) • Text Processing, 1-77 
EDT • Using VMS, 8-71 
EVE editor* Text Processing, 1-71 
saving attributes in • EVE Ref, 1-37 
saving attributes in (EVE) • Text Processing, 1-71, 
1-75, 1-77 

TPU$COMMAND.TPU • EVE Ref, 1-38 
TPUSCOMMAND.TPU file • EVE Ref, 1-8 
TPUSCOMMAND logical name • EVE Ref, 1-8 
VAXTPU • DCL Dictionary, DCL1-191; EVE Ref, 
1-8 

Command image 

definition • Using VMS, 1-6, 1-20, 3-4; DCL 
Concepts, 1-1, 2-1 

interrupting and canceling • Using VMS, 1-20 
to 1-21 

privileged and nonprivileged • Using VMS, 1-20; 
DCL Concepts, 2-1 
Command input scanning 

definition • DCL Concepts, 7-4 
Command interpreter* VMS Intro, 1-3 

controlling error checking of • DCL Dictionary, 
DCL2-182 

specifying alternate • DCL Dictionary, DCL1-392 
COMMAND keypad function 
EDT • Text Processing, 2-21 
Command level 

definition • Using VMS, 1-2; Command 
Procedures, 1-7 
nesting • Using VMS, 6-3 
Command line 

See also Editing the command line 
continuation over multiple lines • Using VMS, 

1-10; DCL Concepts, 1-4 
editing 

enabling • Using VMS, 1-22 
in insert mode • Using VMS, 1-23 
in overstrike mode • Using VMS, 1-23 
list of keys tor‘Using VMS, 1-17 to 1-19 
indicating a comment • DCL Concepts, 1-5 
parts of ‘Using VMS, 1-8; DCL Concepts, 1-3 
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Command line (Cont.) 

recalling • Using VMS, 1-21 to 1-22; DCL 
Concepts, 2-6 to 2-7 

rules for entering parameters • DCL Concepts, 1-6 
rules for entering qualifiers • DCL Concepts, 1-7 
syntax • Using VMS, 1-8 
terminators • Using VMS, 1—19; DCL Concepts, 
2-1 

Command parsing 

definition • DCL Concepts, 7-4 
Command procedure • VMS Intro, 2-1, 5-1, 5-3; 

Files and Devices, 1-8 

accessing foreign volumes • Files and Devices, 
4—20 

and file I/O • Using VMS, 6-13 
case statement in • Using VMS, 6-23 
cleanup • Using VMS, 6-33 
comments in • Using VMS, 1-29, 6-1 
continuing execution of* DCL Dictionary, DCL1-63 
controlling error checking in • DCL Dictionary, 
DCL2-182 

creating • VMS Intro, 5-3 

global symbol in • Using VMS, 6-11 
data line in • Using VMS, 6-6 
debugging • Using VMS, 6-27, 6-28 
definition • Using VMS, 3-4, 6-1 
delaying process of • DCL Dictionary, DCL2-397 
directing output to terminal • Using VMS, 6-12 
displaying command lines of • DCL Dictionary, 
DCL2-237 

displaying prompts of* DCL Dictionary, DCL1-262 
error handling • Using VMS, 6-30 
executing • DCL Dictionary, DCL1-9 
interactively • Using VMS, 6-2 
on remote node • Using VMS, 6-2 
exiting • Using VMS, 6-4 
format • Using VMS, 6-1 
I/O errors in • Using VMS, 6-18 
input • Using VMS, 6-6 

from file • Using VMS, 6-10 
from terminal • Using VMS, 6-10 
interrupting with Ctrl/Y • Using VMS, 6-32 
invoking within a command procedure • Using 
VMS, 6-2 

label* DCL Dictionary, DCL1-52, DCL1-227, 
DCL1-229 

login • Files and Devices, 2-8 

loop in • Using VMS, 6-24 

magnetic tape restriction • Files and Devices, 4-1 

nested • Using VMS, 6-3 

parameters for • DCL Dictionary, DCL1 -9 

passing character string to • Using VMS, 6-7 


Command procedure (Cont.) 

passing data to • Using VMS, 6-6 

passing parameters to • Using VMS, 5-3, 6-7; 

DCL Concepts, 5-1 
passing symbols to • Using VMS, 6-7 
passing symbol to interactively • DCL Dictionary, 
DCL1-262 

position of a label in a command line • DCL 
Concepts, 1-3 

redirecting output* Using VMS, 6-11 
resuming execution of* DCL Dictionary, DCL1-63 
returning status value in • Using VMS, 6-4 
SET DEFAULT command in • Using VMS, 6-13 
setting up disk volume • Files and Devices, 3-21 
setting up magnetic tape volume • Files and 
Devices, 3-22 

setting up volume • Files and Devices, 3-20 
stopping 

and returning to command level 0 • DCL 
Dictionary, DCL2-358 
submitting as batch job • Using VMS, 3-8 
submitting batch jobs • DCL Dictionary, DCL2-376 
subroutines in • Using VMS, 6-25 
symbol substitution • DCL Concepts, 7-4 
terminating • DCL Dictionary, DCL1-222 
testing expressions* DCL Dictionary, DCL1-237 
transferring control within • DCL Dictionary, 
DCL1-52, DCL1-227, DCL1-229 
use of dollar sign prompt • DCL Concepts, 1-3 
using stubs in • Using VMS, 6-27 
using to copy files • Files and Devices, 5-12 
using TYPE command to execute • Using VMS, 
6—2 

variables in • Using VMS, 6-19 
writing file from a • Using VMS, 6-13 
Command processing 

first phase • DCL Concepts, 7-4 
parsing a foreign command • DCL Concepts, 5-8 
second phase • DCL Concepts, 7-4 
third phase • DCL Concepts, 7-4 
Command qualifier • Using VMS, 1-12 

definition • Using VMS, 1-12; DCL Concepts, 1-7 
rules for entering • Using VMS, 1-12 
/COMMAND qualifier • EVE Ref, 1-8 
Command string • VMS Intro, 1-4 
editing • VMS Intro, 1-5 
parts of* VMS Intro, 1-4 
Command symbol 

invoking EVE with • Text Processing, 1-3 
Command values 

date and time formats • Using VMS, 1-14; DCL 
Concepts, 1-13 
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Comment 

character* Command Procedures, 1-3 
in a command line • DCL Concepts, 1-5 
in a command procedure • Using VMS, 1-29, 6-1 
Comment flag • DSR Ref, 3-9 
default • DSR Ref, 3-9 
pairing • DSR Ref, 3-9 
recognizing • DSR Ref, 2-46 
Comparison 

of characters in records • DCL Dictionary, 
DCL1-151 

of files • DCL Dictionary, DCL1-151 
Compiler • VMS Intro, 4-2 
Compiling VAXTPU procedures 

with the EXTEND ALL command • EVE Ref, 
EVE-54 

COMPRESS command • Mail, MAIL-31 
Concatenating files* DCL Dictionary, DCL1-34, 
DCL1-74 
Concatenation 
See also String 

of character strings • DCL Concepts, 5-5 
of symbol names • DCL Concepts, 7-2 
Concealed device name 

definition • DCL Concepts, 4-13 
Conditional commands • DSR Ref, 2-66, 4-8 
controlling execution of • DSR Ref, 4-26 
example • DSR Ref, 2-126 
list of • DSR Ref, 2-68 
variables in • DSR Ref, 2-126 
Conditional tests • Sort/Merge, SORT-58 
Condition code 

as symbol $SEVERITY • Command Procedures, 
7-2 

as symbol $STATUS • Command Procedures, 7-1 
definition • Command Procedures, 7-1 
/CONDITION qualifier • Sort/Merge, SORT-57 
Conference call • Phone, PHONE-2 
CONNECT command* DCL Dictionary, DCL1-60 to 
DCL1-62 

/CONTIGUOUS qualifier • Sort/Merge, SORT-42 
CONTIN.SYS • Files and Devices, A-3 
Continuation character (-) • Command Procedures, 

1-3 

Continuation file • Files and Devices, A-3 
Continuation volume 

mounting • Files and Devices, 3-17 
CONTINUE command • Using VMS, 1-21, 3-5, 8-54; 
DCL Dictionary, DCL1-63 to DCL1-64 
resuming command execution • DCL Concepts, 

2-2, 2-3 

Continuing the command line • DCL Concepts, 1-4 


CONTROL access • Files and Devices, 2-3 
See also Access 
for a device • DCL Concepts, 8-6 
for a file • DCL Concepts, 8-9 
for a global section • DCL Concepts, 8-10 
for a logical name table • DCL Concepts, 8-10 
for a volume • DCL Concepts, 8-7 
in UlC-based protection • DCL Concepts, 8-4 
Control characters • Mail, MAIL-5; Phone, 
PHONE-2 

.CONTROL CHARACTERS command • DSR Ref, 
2-14, A-5 

Control flag • DSR Ref, 3-10 
default • DSR Ref, 3-10 
definition • DSR Ref, 1-2 
recognizing • DSR Ref, 2-47 
CONTROL key • EDT Ref, A-1 
Control keys • EDT Ref, EDT-2 
See also SHOW KEY command 
defining • EDT Ref, EDT-8 
restrictions with QUOTE • EVE Ref, EVE-107 
Controller designation field 

default value • Using VMS, 2-10; DCL Concepts, 

3-6 

definition • Using VMS, 2-9; DCL Concepts, 3-4 
Controller designator • VMS Intro, 3-4 
Conversation text • Phone, PHONE-2 
CONVERT command* DCL Dictionary, DCL1-65 
CONVERT/DOCUMENT command • DCL Dictionary, 
DCL1-66 to DCL1-72 

creating an options file • DCL Dictionary, DCL1-67 
Converting from EDT to EVE • EVE Ref, 1-39 
equivalent commands • EVE Ref, A-1 
CONVERT/RECLAIM command • DCL Dictionary, 
DCL1-73 

CONVERT TABS command • EVE Ref, EVE-29 
using with search string (EVE) • Text Processing, 
1-20 

Convert Utility (CONVERT) 

using to transfer information • Files and Devices, 
5-8 

COPY command • VMS Intro, 6-8; Using VMS, 
1-33, 2-16; Files and Devices, 4-1, 5-1; Mail, 
MAIL-10, MAIL-32; DCL Concepts, 3-5, 3-19, 
8-9; DCL Dictionary, DCL1-74 to DCL1-83; 
EVE Ref, EVE-30 
ANSI-labeled volumes 

copying from • Files and Devices, 5-3 
disk files • Files and Devices, 5-2 
EDT editor • Text Processing, 2-30, 2-36 
/LOG qualifier • Files and Devices, 5-7 
magnetic tape • Files and Devices, 4-15 
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COPY command 

magnetic tape (Cont.) 

copying files from • Files and Devices, 5—3 
copying to • Files and Devices, 5-2 
moving text with (EVE) • Text Processing, 1-19 
non-file-structured volumes • Files and Devices, 
5-6 

printing DSR output with • Using VMS, 9-20 
to rename files • DCL Concepts, 3-19 
using with DECwindows compound documents • 
DCL Dictionary, DCL1-75 
using with search string (EVE) • Text Processing, 
1-20 
Copying mail 

to a sequential file • Mail, MAIL-3 
Copying text 

COPY • EDT Ref, EDT-125 
/DUPLICATE qualifier • EDT Ref, EDT-137 
EVE editor* Text Processing, 1-21 
INCLUDE • EDT Ref, EDT-147 
PASTE • EDT Ref, EDT-298 
PRINT • EDT Ref, EDT-157 
WRITE • EDT Ref, EDT-253 
Core image file • Files and Devices, A—3 
CORIMG.SYS • Files and Devices, A-3 
Corruption 

of data • Files and Devices, 3-19 
Count specifier 

nokeypad mode • EDT Ref, EDT-274 
with APPEND • EDT Ref, EDT-261 
with CHGC (change case) • EDT Ref, EDT-266 
with CHGL (change case lower) • EDT Ref, 
EDT-267 

with CHGU (change case upper) • EDT Ref, 
EDT-268 

with circumflex ( A ) • EDT Ref, EDT-269 
with CUT • EDT Ref, EDT-275 
with D (delete) • EDT Ref, EDT-276 
with FILL • EDT Ref, EDT-289 
with “move” • EDT Ref, EDT-296 
with PASTE • EDT Ref, EDT-298 
with R (replace) • EDT Ref, EDT-302 
with S (substitute) • EDT Ref, EDT-305 
with SHL (shift left) • EDT Ref, EDT-309 
with SHR (shift right) • EDT Ref, EDT-310 
with SN (substitute next) • EDT Ref, EDT-311 
with TAB* EDT Ref, EDT-315 
with TADJ (tab adjust) • EDT Ref, EDT-317 
with TD (tab decrement) • EDT Ref, EDT-320 
with Tl (tab increment) • EDT Ref, EDT-323 
with UNDC (undelete character) • EDT Ref, 
EDT-326 


Count specifier (Cont.) 

with UNDL (undelete line) • EDT Ref, EDT-327 
with UNDW (undelete word) • EDT Ref, EDT-329 
CPU (central processing unit) 

defining default time limit for batch jobs • DCL 
Dictionary, DCL1-253, DCL2-204, DCL2-347 
defining maximum time limit for batch jobs • 

DCL Dictionary, DCL1-253, DCL1-267, 
DCL2-205, DCL2-348 
displaying error count for • DCL Dictionary, 
DCL2-279 

limiting time for batch job • DCL Dictionary, 

DCL2-138, DCL2-379 

time used by current process • DCL Dictionary, 
DCL2-319 

CREATE command • VMS Intro, 2-4; Using VMS, 
2-16; DCL Dictionary, DCL1-84 to DCL1-88 
magnetic tape • Files and Devices, 4-19 
CREATE/DIRECTORY command • VMS Intro, 3-8; 
Using VMS, 2-21, 7-11; Files and Devices, 
2-12, 4-15; DCL Concepts, 3-12, 8-8; DCL 
Dictionary, DCL1-89 to DCL1-91 
CREATE/FDL command • DCL Dictionary, DCL1-92 
CREATE/NAME_TABLE command • Using VMS, 
4-14; DCL Concepts, 4-15, 8-10; DCL 
Dictionary, DCL1-93 to DCL1-96 
/CREATE qualifier • EVE Ref, 1-9 
CREATE/TERMINAL command • DCL Dictionary, 
DCL1-97 to DCL1-102 
Creating a subprocess • Mail, MAIL—104 
Creating distribution lists • Mail, MAIL-6 
Creating files • Mail, MAIL-3 
with EDT • EDT Ref, EDT-1 
Creation date field • Files and Devices, B-12 
zero creation date • Files and Devices, B—13 
Ctrl/A • EDT Ref, EDT-30 
See also Tabbing functions 
changing editing mode with • Text Processing, 
1-12 

command line editing with • Text Processing, 1-6 
Ctrl/B • DCL Concepts, 2-7 

recalling command line with • Text Processing, 1-7 
recalling commands with • Using VMS, 1-18, 

1-21; DCL Concepts, 2-6 
Ctrl/C • Mail, MAIL-5 
See also Ctrl/Y 
See also Sending messages 
and CONTINUE command • DCL Dictionary, 
DCL1-63 

and corrupted EVE journal file • Using VMS, 8-24 
canceling a MAIL message with • Using VMS, 
1-28 

canceling EDT command with • Using VMS, 8-51 
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Ctrl/C (Cont.) 

continuing after • DCL Dictionary, DCL1-63 
interrupting or canceling DCL commands with • 
Using VMS, 1-17, 1-20, 1-21; DCL 
Concepts, 2-1,2-7 
keypad mode • EDT Ref, EDT-32 
See also Aborting operation 
line mode • EDT Ref, EDT-127 
See also Aborting operation 
nokeypad mode • EDT Ref, EDT-272 
See also Aborting operation 
restriction with keystroke journaling • DCL 
Dictionary, DCL1-200 
Ctrl/D -EDT Ref, EDT-34 
See also Tabbing functions 
Ctrl/E • EDT Ref, EDT-35 
See also Tabbing functions 
command line editing with • Text Processing, 1-6 
moving the cursor with ♦ Text Processing, 1-8 
Ctrl/F • EDT Ref, EDT-67 
Ctrl/H • EDT Ref, EDT-22 
See also Tabbing functions 
moving the cursor with • Text Processing, 1-8 
Ctrl/I -EDTRef, EDT-103 
See also Formatting, text 
See also Tabbing functions 
formatting text with • Text Processing, 1-39 
Ctrl/J • EDT Ref, EDT-79 
See also Deleting text 
erasing text with • Text Processing, 1-14 
Ctrl/K • EDT Ref, EDT-37 
See also Defining keys 
Ctrl/L • EDT Ref, EDT-40 

formatting text with • Text Processing, 1-39 
Ctrl/M >EDT Ref, EDT-42 

formatting text with • Text Processing, 1-39 
Ctrl/O 

See TYPE command 
Ctrl/Q 

See TYPE command 

resuming scrolling of terminal display • VMS Intro, 
2-5 

Ctrl/R • EDT Ref, EDT-44, EDT-128 
Ctrl/S 

See TYPE command 

stopping scrolling of terminal display • VMS Intro, 
2-5 

Ctrl/T • EDT Ref, EDT-45 
See also Tabbing functions 
checking the status of your process • VMS Intro, 
1-7 


Ctrl/T (Cont.) 

enabling • Using VMS, 1-20 
interrupting DCL commands with • Using VMS, 
1-18, 1-20; DCL Concepts, 2-1, 2-8 
Ctrl/U • DCL Concepts, 2-5, 2-6, 2-8; EDT Ref, 
EDT-47 

See also Deleting text 
See also FIND keypad function 
command line editing with • Text Processing, 1-6 
erasing text with • Text Processing, 1-14 
Ctrl/V 

inserting characters with • Text Processing, 1-12 
inserting escape characters • Text Processing, 
1-13 

Ctrl/W • EDT Ref, EDT-48 
See also Refreshing screen 
refreshing screen display in EDT with • Using 
VMS, 8-53 

refreshing screen display in EVE with • Using 
VMS, 8-23 

refreshing screen display with • Using VMS, 1-18, 
3-5 

refreshing the screen with • Text Processing, 1-38 
Ctrl/V 

See also Ctrl/C 

aborting remote session with • Using VMS, 1-4 
action taken during execution • Command 
Procedures, 7-6 

and CONTINUE command • DCL Dictionary, 
DCL1-63 

and EXIT command* DCL Dictionary, DCL1-222 
and login procedure • DCL Dictionary, DCL1-392 
and ON command • DCL Dictionary, DCL2-2 
continuing after* DCL Dictionary, DCL1-63 
default action for nested procedure • Command 
Procedures, 7-9 

disabling • Command Procedures, 7-10 
interrupting a command procedure with • Using 
VMS, 6—30, 6—32; DCL Concepts, 7—6; 
Command Procedures, 7-6 
interrupting an EDT editing session with • Using 
VMS, 8-54 

interrupting an image with • Using VMS, 3-5 
interrupting or canceling DCL commands with • 
Using VMS, 1-18, 1-20, 1-21; DCL 
Concepts, 2-1, 2-8 

restriction with SPELL command • EVE Ref, 
EVE-232 

with ON command • Command Procedures, 7-7 
Ctrl/Z • Mail, MAIL-1, MAIL-5; DCL Concepts, 2-1, 
2-8 

See also Sending messages 
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Ctrl/Z (Cont.) 

as command line terminator • Using VMS, 1-19 
as end-of-file terminator* Using VMS, 1-17, 2-16 
keypad mode • EDT Ref, EDT-49 
See also Entering commands 
line mode • EDT Ref, EDT-129 
See also Entering commands 
nokeypad mode • EDT Ref, EDT-273 
See also Entering commands 
sending a MAIL message with • Using VMS, 1-28 
with I (insert) • EDT Ref, EDT-292 
with INSERT • EDT Ref, EDT-148 
with R (replace) • EDT Ref, EDT-302 
with REPLACE • EDT Ref, EDT-165 
writing a file in EDT with • Using VMS, 8-48 
writing a file in EVE with • Using VMS, 8-3 
Ctrl functions 

enabling or disabling 

Ctrl/C* DCL Dictionary, DCL2-118 
Ctrl/T • DCL Dictionary, DCL2-118 
Ctrl/Y • DCL Dictionary, DCL2-118 
Ctrl keys • Using VMS, 1-17 to 1—19; DCL 
Concepts, 2-5 to 2-6, 2-7 to 2-8 
CURRENT command • Mail, MAIL-35 
See also Reading 
Cursor control 

in EDT • Using VMS, 8-54, 8-58; Text 
Processing, 2-10 

in EVE • Using VMS, 8-8; Text Processing, 1-8 
Cursor direction 

ADV (advance) • EDT Ref, EDT-260 
ADVANCE • EDT Ref, EDT-18 
BACK • EDT Ref, EDT-263 
BACKUP • EDT Ref, EDT-23 
Cursor motion 

commands and keys affected • EVE Ref, EVE-153 
Cursor movement 

BACKSPACE • EDT Ref, EDT-22 

CHAR • EDT Ref, EDT-25 

DOWN arrow • EDT Ref, EDT-63, EDT-283 

EOL • EDT Ref, EDT-66 

LEFT arrow • EDT Ref, EDT-77, EDT-295 

LINE • EDT Ref, EDT-78 

"move" • EDT Ref, EDT-296 

PAGE • EDT Ref, EDT-82 

RIGHT arrow • EDT Ref, EDT-92, EDT-304 

SECT • EDT Ref, EDT-93 

SET CURSOR • EDT Ref, EDT-175 

SET WORD DELIMITERS • EDT Ref, EDT-203 

TOP • EDT Ref, EDT-105 

UP arrow • EDT Ref, EDT-111, EDT-331 


Cursor movement (Cont.) 

WORD • EDT Ref, EDT-112 
Cursor positioning • EDT Ref, EDT-30, EDT-315 
BACKSPACE • EDT Ref, EDT-66 
BOTTOM • EDT Ref, EDT-24 
KS (KED substitute) • EDT Ref, EDT-294 
SET PARAGRAPH WPS • EDT Ref, EDT-185 
SHOW CURSOR • EDT Ref, EDT-210 
Customizing editing sessions 

EVE editor* Text Processing, 1-71,1-75 
CUT command • Using VMS, 8-65; EDT Ref, 
EDT-50, EDT-275; EVE Ref, EVE-31 

See also Deleting text 
See also Moving text 
See also REMOVE command 
moving text with (EVE) • Text Processing, 1—19 
using with search string (EVE) • Text Processing, 
1-20 

CUT keypad function 

EDT • Text Processing, 2-14, 2-18, 2-20 


D_ 

D (delete) command • EDT Ref, EDT-276 
See also Deleting text 
Data 

logical • Using VMS, 5-10, 5-15 
numeric* Using VMS, 5-8, 5-13 
passing to command procedure • Using VMS, 6-6 
storing • Using VMS, 5-1 
Data check 

changing default • DCL Dictionary, DCL2-240 
Data lines • Command Procedures, 1-2 

in command procedures • Command Procedures, 
3-5 

/DATA qualifier • Sort/Merge, SORT-60 
Data record compaction 

TA90E support* DCL Dictionary, DCL1-246, 
DCL2-177 
Data stream 

marking beginning of • DCL Dictionary, DCL1-111 
marking end of* DCL Dictionary, DCL1-206 
Data type • Using VMS, 2-4 

DCL conversion rules • Command Procedures, 
2-13 

specifying • Sort/Merge, SORT-62 
Date 

See also Absolute time 
See also Combination time 
See also Delta time 
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Date (Cont.) 

changing system • DCL Dictionary, DCL2-234 
displaying • DCL Dictionary, DCL2-328 
specifying absolute and delta combinations • DCL 
Concepts, 1-16 

specifying absolute and delta date and time 
combinations • Using VMS, 1-16 
specifying absolute date and time • Using VMS, 
1-15 

specifying absolute time* DCL Concepts, 1-14 
specifying delta date and time* Using VMS, 1-16 
specifying delta time • DCL Concepts, 1-15 
$$Date • DSR Ref, 3—18 
.DATE command • Text Processing, 3-38, 3-42; 
DSR Ref, 2-15 

DATE command • EDT Ref, EDT-278 
Date within running head 
See Running head 
Day 

setting default type • DCL Dictionary, DCL2-120 
$$Day • DSR Ref, 3-18 
DBG$INPUT • DCL Concepts, 4-7 
DBG$OUTPUT • DCL Concepts, 4-7 
DCL (DIGITAL Command Language) 
defined • VMS Intro, 1-3 
definition • Using VMS, 1-1 
using • Using VMS, 1-6 

DCL command • EVE Ref, EVE-32 to EVE-33 
using in EVE ♦ Text Processing, 1-65 
DCL command level 

definition • Using VMS, 1-2 
DCL commands • VMS Intro, 1-3; Using VMS, 1-6; 
Mail, MAIL-1 

continuing execution of • DCL Dictionary, DCL1-63 
executing within EVE • Using VMS, 8-46 
interrupting or canceling 

with Ctrl/C 'Using VMS, 1-17, 1-20, 1-21 
with Ctrl/Y • Using VMS, 1-18, 1-20, 1-21 
interrupting with Ctrl/T • Using VMS, 1-18, 1-20 
marking beginning of input stream • DCL 
Dictionary, DCL1-111 

marking end of input stream • DCL Dictionary, 
DCL1-206 
recalling 

with Ctrl/B • Using VMS, 1-18 
with DOWN arrow key* Using VMS, 1-18 
with UP arrow key • Using VMS, 1-18 
restrictions on • Files and Devices, 4-1 
resuming execution of • DCL Dictionary, DCL1-63 
DCL prompt • Using VMS, 1-2, 1-6 

in command procedures • DCL Concepts, 1-3 
DCL qualifiers • Mail, MAIL-19 to MAIL-23 


DDIF (Digital Document Interchange Format) 
analyzing files encoded in • DCL Dictionary, 
DCL1-70 

DEALLOCATE command • Files and Devices, 3-20; 
DCL Dictionary, DCL1-103 
and ALLOCATE command • DCL Dictionary, 
DCL1-15, DCL1-103 
magnetic tape • Files and Devices, 4-16 
Deallocating devices • DCL Dictionary, DCL1-103 
DEASSIGN command • Using VMS, 4-5; DCL 
Concepts, 4-4; Command Procedures, 2-2; 
DCL Dictionary, DCL1-104 to DCL1-108 
and DEFINE command • DCL Dictionary, 
DCL1-114 

and process logical name table • Using VMS, 4-5 
default logical name table • DCL Concepts, 4-5 
to delete a logical name table • DCL Concepts, 
4-16 

DEASSIGN/QUEUE command • DCL Dictionary, 
DCL1-109 

DEBUG command • DCL Dictionary, DCL1-110 
Debugger* VMS Intro, 4-10, 4-14 

and RUN (Image) command • DCL Dictionary, 
DCL2-51 

including in output image • DCL Dictionary, 
DCL1-386 

information record analysis • DCL Dictionary, 
DCL1-27 

invoking* DCL Dictionary, DCL1-30, DCL1-110 
using with DEPOSIT command • DCL Dictionary, 
DCL1-147 

using with EXAMINE command • DCL Dictionary, 
DCL1-209 

Debugger information records 

analyzing in object file • DCL Dictionary, DCL1-27 
Debugging 

VAXTPU • DCL Dictionary, DCL1-192; EVE Ref, 
1-9 

/DEBUG qualifier • DSR Ref, 2-126, 4-8; EVE Ref, 
1-9 

Decimal dump ♦ DCL Dictionary, DCL1-175 
Decimal value 

of character • EDT Ref, A-1 
DECK command • Using VMS, 6-6; Command 
Procedures, 3-5; DCL Dictionary, DCL1-111 to 
DCL1-113 

and EOD command • DCL Dictionary, DCL1-206 
DEC Multinational Character Set • Using VMS, A-5; 
EDT Ref, A-1 

DEC multinational character support • DSR Ref, 2-14 
DECnet • DCL Dictionary, DCL2-149, DCL2-171, 
DCL2-173 
See also Network 
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DECnet (Cont.) 

logging in to remote systems with • Using VMS, 

1-3 

running DECwindows applications across • DCL 
Dictionary, DCL2-133 
use with • Phone, PHONE-8 
DECnet-VAX • Mail, MAIL-7, MAIL-15, MAIL-18 
access violation • Using VMS, 2-16 
and logical node name • Using VMS, 4-16 
file manipulation with • Using VMS, 2-16 
DECspell 

See SPELL command 
DECterm window 

setting application keypad • DCL Dictionary, 
DCL1-98 

DECW$DISPLAY • DCL Dictionary, DCL2-129, 
DCL2-272 

DECwindows • EVE Ref, 1-10, 1-12 
changing menu entries • EVE Ref, 1-2 
EVE*DCL Dictionary, DCL1-193, DCL1-195 
quick copy • EVE Ref, 1-3 
VAXTPU • DCL Dictionary, DCL1-193, DCL1-195 
DECwindows function keys • EVE Ref, 1-27, 

EVE-164 

/DEEPESTJHEADER qualifier • DSR Ref, 5-3 
Default 

definition • VMS Intro, 1-6 
Default change mode • EDT Ref, EDT-183 
Default characteristics 

modifying terminal • DCL Dictionary, DCL2—221 to 
DCL2-233 

setting for magnetic tape device • DCL Dictionary, 
DCL2-177 
Default device 

displaying • DCL Dictionary, DCL2—262 
setting • DCL Dictionary, DCL2—121 
Default directory 

displaying • DCL Dictionary, DCL2-262 
setting* DCL Dictionary, DCL2—121 
Default editor 

setting • Mail, MAIL-13 
Default error checking 

controlling • DCL Dictionary, DCL2-182 
Default file type 

table of‘DCL Concepts, 3-14 
Default libraries 

displaying help • DCL Dictionary, DCL1 -232 
Default printer 

displaying characteristics of • DCL Dictionary, 
DCL2-300 

Default protection • Using VMS, 7—5, 7—10; Files and 
Devices, 2-8 


Default protection (Cont.) 

establishing • DCL Dictionary, DCL2-199 
$DEFAULTS$ buffer* EVE Ref, 1-32, EVE-223 
Default settings • EVE Ref, 1-29 
Default UIC 

changir^ • DCL Dictionary, DCL2—236 
Default values 

in file specifications • Using VMS, 2-12; DCL 
Concepts, 3-22 

provided by system • Using VMS, 1-11 
Default working set 

for batch job • DCL Dictionary, DCL1-260, 
DCL1-269, DCL2-208, DCL2-353, 
DCL2-383 

modifying size • DCL Dictionary, DCL2-244 
DEFAULT_PROTECTION access control list entry • 
Using VMS, 7-9 

DEFINE/CHARACTERISTIC command • DCL 
Dictionary, DCL1-120 to DCL1-121 
DEFINE command • VMS Intro, 3-9; Using VMS, 
4-2; Command Procedures, 2-2; DCL 
Dictionary, DCL1-114 to DCL1-119 

See also ASSIGN command 
and DEASSIGN command • DCL Dictionary, 
DCL1-104 

and process logical name table • Using VMS, 4-5 
default logical name table • DCL Concepts, 4—5 
example with access mode qualifier • Using VMS, 
4-13; DCL Concepts, 4-14 
function • DCL Concepts, 4-2 
how it handles a colon in a logical name • DCL 
Concepts, 4-2 

specifying the access mode • DCL Concepts, 1-8, 
4—14 

specifying the access mode with • Using VMS, 

4—13 

DEFINE/FORM command • DCL Dictionary, 
DCL1-122 to DCL1-125 
DEFINE KEY command* EDT Ref, EDT-10, 
EDT-130 

See also Defining keys 

DEFINE/KEY command • VMS Intro, 6-10; Using 
VMS, 1-24, 1-35, 8-39, 8-71, 8-73; Mail, 
MAIL-36; DCL Dictionary, DCL1-126 to 
DCL1-130; EVE Ref, EVE-34 to EVE-35 
EDT editor* Text Processing, 2-45, 2-51, 2-53 
EVE editor • Text Processing, 1-60 
in an initialization file (EVE) • Text Processing, 
1—61 

in initialization file • Mail, MAIL-16 
DEFINE MACRO command • Using VMS, 8-74; 
EDT Ref, EDT-133 

EDT editor • Text Processing, 2-51, 2-53 
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DEFINE MENU ENTRY command ♦ EVE Ref, 
EVE-36 to EVE-37 

Defining keys • Mail, MAIL-36; EDT Ref, EDT-8; 
EVE Ref, 1-25 
Ctrl/K • EDT Ref, EDT-37 
DEFINE KEY • EDT Ref, EDT-130 
DEFK (define key) • EDT Ref, EDT-279 
EVE editor* Text Processing, 1-59 
GOLD • EDT Ref, EDT-73 
in an initialization file (EVE) • Text Processing, 
1—61 

SHOW KEY • EDT Ref, EDT-9 
to execute commands (EVE) • Text Processing, 
1-60 

DEFK (define key) command • EDT Ref, EDT-279 
See also Defining keys 

Delaying command processing • DCL Dictionary, 
DCL2-397 
See also Wait state 
DEL C keypad function 

EDT* Text Processing, 2-14 
DEL C keypad function (EDT) • Using VMS, 8-59; 
EDT Ref, EDT-52 

See also Deleting text 
See also Restoring deleted text 
DEL EOL keypad function 
EDT* Text Processing, 2-14 
DEL EOL keypad function (EDT) • Using VMS, 8-61; 
EDT Ref, EDT-54 

See also Deleting text 
DELETE access 
See also Access 

explicitly assigning • Files and Devices, 2-12 
for a directory • DCL Concepts, 8-8 
for a file • DCL Concepts, 8-9 
for a logical name table • DCL Concepts, 8-10 
for a queue • DCL Concepts, 8-7 
for a volume • DCL Concepts, 8-7 
Delete access category 
definition • Using VMS, 7-4 
DELETE BUFFER command • Using VMS, 8-31, 
8-32; EVE Ref, EVE-40 to EVE-41 
for buffer manipulation (EVE) • Text Processing, 
1-47 

keywords with (EVE) • Text Processing, 1-50 
DELETE/CHARACTERISTIC command • DCL 
Dictionary, DCL1-135 

DELETE command • VMS Intro, 1-13, 2-4; Using 
VMS, 1-32, 2-17; Mail, MAIL-39; DCL 
Concepts, 3-12; DCL Dictionary, DCL1-131 
to DCL1-134; EDT Ref, EDT-56, EDT-135; 
EVE Ref, EVE-38 to EVE-39 


DELETE command (Cont.) 

See also Deleting text 
and wildcard characters • Using VMS, 2-17 
EDT editor ♦ Text Processing, 2-27 
EVE editor* Text Processing, 1-15 
using with search string (EVE) • Text Processing, 
1-20 

DELETE/ENTRY command • Command Procedures, 
8-8; DCL Dictionary, DCL1-136 to DCL1-138 
using with a batch queue • VMS Intro, 6-4 
using with a print queue • VMS Intro, 6-2 
DELETE/FORM command • DCL Dictionary, 

DCL1-139 

DELETE/INTRUSION_RECORD command • DCL 
Dictionary, DCL1-140 
Delete key 

erasing text with (EVE) • Text Processing, 1-14 
DELETE key Using VMS, 1-18; DCL Concepts, 
2—5 

DELETE/KEY command • VMS Intro, 6-11; Using 
VMS, 1-26; DCL Dictionary, DCL1-141 
DELETE/QUEUE command • DCL Dictionary, 
DCL1-143 to DCL1-144 
DELETE/SYMBOL command • Using VMS, 5-5; 

DCL Concepts, 5-4; Command Procedures, 
2-9; DCL Dictionary, DCL1-145 to DCL1-146 
DELETE WINDOW command • Using VMS, 8-35; 
EVE Ref, EVE-42 

in window environment (EVE) • Text Processing, 
1-55 
Deleting 

batch job file after processing • DCL Dictionary, 
DCL2-379 

batch queue • DCL Dictionary, DCL1-143 
batch queue entries • DCL Dictionary, DCL1-136 
files • Mail, MAIL-12; DCL Dictionary, DCL1-131 
folders • Mail, MAIL-12 
logical names* DCL Dictionary, DCL1-104 
logical name tables • DCL Dictionary, DCL1-104 
messages • Mail, MAIL-8, MAIL-66 
multiple files • DCL Dictionary, DCL1-131 
print queue* DCL Dictionary, DCL1-143 
print queue entries* DCL Dictionary, DCL1-136 
wakeup request • DCL Dictionary, DCL2-55 
Deleting text 

CLEAR • EDT Ref, EDT-124 
Ctrl/J • EDT Ref, EDT-79 
Ctrl/U • EDT Ref, EDT-47 
CUT • EDT Ref, EDT-275 
D (delete) • EDT Ref, EDT-276 
DEL C • EDT Ref, EDT-52 
DEL EOL • EDT Ref, EDT-54 
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Deleting text (Cont.) 

DELETE • EDT Ref, EDT-56, EDT-135 
DEL L • EDT Ref, EDT-57 
DEL W • EDT Ref, EDT-59 
LINEFEED • EDT Ref, EDT-79 
Delimiters • EDT Ref, EDT-176, EDT-211, EDT-238 
SET WORD DELIMITERS • EDT Ref, EDT-203 
DEL L keypad function 

EDT • Text Processing, 2-14 
DEL L keypad function (EDT) • Using VMS, 8-61; 
EDT Ref, EDT-57 
See also Deleting text 
See also Restoring deleted text 
Delta time 

combined with absolute time • Using VMS, 1—16; 
DCL Concepts, 1-16 

default values • Using VMS, 1—16; DCL Concepts, 
1-15 

examples • Using VMS, 1—16; DCL Concepts, 
1-16 

rules for entering • Using VMS, 1-16; DCL 
Concepts, 1-15 

syntax • Using VMS, 1-16; DCL Concepts, 1-15 
DEL W command • Using VMS, 8-60; EDT Ref, 
EDT-59 

See also Deleting text 
See also Restoring deleted text 
DEL W keypad function 

EDT • Text Processing, 2-14 
DEPOSIT command • DCL Concepts, 7-1, 7-4; 

DCL Dictionary, DCL1-147 to DCL1-150 
and EXAMINE command • DCL Dictionary, 
DCL1-209 

length qualifiers* DCL Dictionary, DCL1-148 
radix qualifiers • DCL Dictionary, DCL1-148 
DESEL (deactivate select) command • EDT Ref, 
EDT-280 

See also Entering commands 
Detached process 
See Process 

batch job as • Using VMS, 3-8 
creating with unique UIC • Using VMS, 7-3 
definition • Using VMS, 3-1 
Device • VMS Intro, 3-1, 3-4; Using VMS, 2-1, 2-8 

See also Logical name 
access • DCL Dictionary, DCL1-15 
accessing in batch job • Files and Devices, 3-21 
allocation • DCL Dictionary, DCL1—15 
assigning logical queue name to • DCL Dictionary, 
DCL1-47 

creating • DCL Dictionary, DCL2-129 


Device (Cont.) 

deallocating • DCL Dictionary, DCL1—103 
default name • Using VMS, 2—10 
dismounting • DCL Dictionary, DCL1-170 
displaying 

default • DCL Dictionary, DCL2—262 
error count for • DCL Dictionary, DCL2—279 
information on • DCL Dictionary, DCL2-246 
mounted volumes • DCL Dictionary, 

DCL2-266 

queue entries • DCL Dictionary, DCL2—275, 
DCL2-309 

status of • DCL Dictionary, DCL2-264 
establishing as spooled • DCL Dictionary, 

DCL2-123 

establishing operational status for • DCL 
Dictionary, DCL2-123 
LN01 • DSR Ref, 4-9 
LN01E • DSR Ref, 4-9 
LN03 • DSR Ref, 4-9 

logical name assignment • DCL Dictionary, 
DCL1-15 
magnetic tape 

retrieving information • Files and Devices, 4-6 
setting default characteristics for • DCL 
Dictionary, DCL2-177 

mass storage • Using VMS, 2—8; DCL Concepts, 
3—4 

modifying • DCL Dictionary, DCL2-129 
modifying protection of • DCL Dictionary, 
DCL2-200 

name • VMS Intro, 3—4, 3—5 
nonfile • Using VMS, 7-12 
physical • VMS Intro, 6-16 
protection • Files and Devices, 2-13 
record-oriented • Using VMS, 2-8; DCL 
Concepts, 3-4 

setting default to another • Using VMS, 2—23 
type • VMS Intro, 3-4 

unit record • Using VMS, 2—8; DCL Concepts, 
3-4 

unloading with DISMOUNT command • DCL 
Dictionary, DCL1-172 
Device code 

definition • Using VMS, 2-9 
Device code field 

definition • DCL Concepts, 3-4 
in a cluster device name • DCL Concepts, 3-6 
Device control library • DSR Ref, B-4 
Device driver image 

patching • DCL Dictionary, DCL2-11 
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Device field 

default value • Using VMS, 2-12; DCL Concepts, 
3-22 

definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
Device name 

See also Cluster device name 
See also Device field 
See also Physical device name 
assigning logical name to • DCL Dictionary, 
DCL1-39, DCL1-114 
concealed • Using VMS, 4-13 
generic • Using VMS, 2-10; DCL Concepts, 3-6 
rules for entering • Using VMS, 2-9; DCL 
Concepts, 3-4 

using a logical name • Using VMS, 2-10; DCL 
Concepts, 3-6 

Device protection • Using VMS, 7-12 
access types • DCL Concepts, 8-6 
commands for setting • DCL Concepts, 8-6 
Dialing • Phone, PHONE-10, PHONE-18 
Dialing in • Using VMS, 1-4 
DIFFERENCES command • VMS Intro, 6-7; DCL 
Dictionary, DCL1-151 toDCLI-158 
comment characters • DCL Dictionary, DCL1-153 
comment delimiters • DCL Dictionary, DCL1-153 
exit status* DCL Dictionary, DCL1-152 
output formats* DCL Dictionary, DCL1-156 
DIGITAL Command Language 
See DCL 

Digital Document Interchange Format 
See DDIF 

DIGITAL Standard Runoff 
See DSR 
Direction 

See also CHANGE DIRECTION command 
commands and keys affected • EVE Ref, EVE-25 
with FIND command • EVE Ref, EVE-63, EVE-69, 
EVE-133 

with RESET command • EVE Ref, EVE-122 
with SELECT command • EVE Ref, EVE-142 
with WILDCARD FIND command • EVE Ref, 
EVE-245 

with WPS keypad Select • EVE Ref, EVE-184 
Directory • Phone, PHONE-11 

changing specification • DCL Dictionary, DCL2-34 
copying • DCL Dictionary, DCL1-74 
creating • Files and Devices, 4-15; DCL 
Dictionary, DCL1-89 
creating UIC • DCL Dictionary, DCL1-89 
definition • VMS Intro, 3-5 
displaying contents of • DCL Dictionary, DCL1-159 


Directory (Cont.) 

displaying default* DCL Dictionary, DCL2-262 
file version limit 

defining at creation • DCL Dictionary, 
DCL1-90 

modifying • DCL Dictionary, DCL2-126 
modifying number in system space 

for Files-11 volume* DCL Dictionary, 
DCL2-240 

protection • Files and Devices, 2-12 
defining at creation • DCL Dictionary, 
DCL1-90 

modifying • DCL Dictionary, DCL2-196 
ready access • DCL Dictionary, DCL1-241 
role in file specification • VMS Intro, 3-1 
space preallocation on disk • DCL Dictionary, 
DCL1-243 

DIRECTORY command* VMS Intro, 1-12, 1-17, 

2-6; Using VMS, 1-31, 1-33, 2-20, 7-12; 

Files and Devices, 2-13, 4-2, 4-18; Mail, 
MAIL-11, MAIL-41; DCL Concepts, 3-12; DCL 
Dictionary, DCL1-159 to DCL1-167 
/FULL qualifier • Files and Devices, 4-18 
magnetic tape • Files and Devices, 4-4, 5-2 
Directory field 

default value • Using VMS, 2-12; DCL Concepts, 
3—22 

definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
rules for using an asterisk (*) wildcard • Using 
VMS, 2-14; DCL Concepts, 3-18, 3-20 
rules for using an ellipsis (...) wildcard • DCL 
Concepts, 3-20 

rules for using a percent sign (%) wildcard • Using 
VMS, 2-15; DCL Concepts, 3-19 
Directory file 

See also Directory structure 

creating • Using VMS, 2-21 

default • Using VMS, 2-6, 2-22 

definition • Using VMS, 2-6; DCL Concepts, 3-7 

deleting • Using VMS, 2-21; DCL Concepts, 

3-12, 8-8 

login • Using VMS, 2-6 
named format • Using VMS, 2-8 
protection • Using VMS, 7-11 
setting default to another • Using VMS, 2-22 
top level • Using VMS, 2-1, 2-6 
Directory hierarchy 

definition • DCL Concepts, 3-7 
example • DCL Concepts, 3-7 
Directory name 

See also Directory field 
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Directory name (Cont.) 

named format in a file specification • Using VMS, 

2- 8; DCL Concepts, 3-9 
replacing 

with the ellipsis (...) wildcard character • Using 
VMS, 2-23 

with the hyphen (-) wildcard character • Using 
VMS, 2-24 

translating UIC format to named format* DCL 
Concepts, 3-10 

UIC format in a file specification • DCL Concepts, 

3— 9 

using the ellipsis (...) wildcard • DCL Concepts, 
3-10 

using the hyphen (-) wildcard • DCL Concepts, 

3-12 

Directory protection 

access types • DCL Concepts, 8—8 
commands for setting • DCL Concepts, 8-8 
DIRECTORY/PROTECTION command • DCL 
Concepts, 8-9 

Directory structure • Using VMS, 2-1 
default directory • DCL Concepts, 3-7 
duplicating • DCL Concepts, 3-20 

with BACKUP command • Using VMS, 2-25 
with wildcard characters • Using VMS, 2-25 
hierarchy • DCL Concepts, 3-7 
master file directory in • Using VMS, 2-1, 2-6; 

DCL Concepts, 3-7 
sample • Using VMS, 2-7 
subdirectory in • Using VMS, 2-6; DCL Concepts, 
3-7 

top-level directory in • Using VMS, 2-1, 2-6; DCL 
Concepts, 3-7 

user file directory in • Using VMS, 2-1, 2-6; DCL 
Concepts, 3-7 

.DISABLE BAR command • DSR Ref, 2-26 
.DISABLE BOLDING command • DSR Ref, 2-29 
.DISABLE HYPHENATION command • DSR Ref, 

2-30 

.DISABLE INDEXING command • DSR Ref, 2-31 
.DISABLE OVERSTRIKING command • DSR Ref, 
2-32 

.DISABLE TOC command • DSR Ref, 2-33 
.DISABLE UNDERLINING command • DSR Ref, 2-34 
DISCONNECT command • DCL Dictionary, 
DCL1-168 to DCL1-169 
Disk* Using VMS, 2-8 
See also Device 
accessing 

examples of • Files and Devices, 4—13 
allocating mapping pointers • DCL Dictionary, 
DCL1-248 


Disk (Cont.) 

allocating to process • Files and Devices, 3-1 
allocation of space on • Files and Devices, 1-4, 

4—8, 4—9 

basic concepts • Files and Devices, 1-2 
block 

cluster • Files and Devices, 1-2 
description of • Files and Devices, 1—2 
contents of • Using VMS, 2-6, 2-8 
copying files • Files and Devices, 5—2 
creating sequential files • DCL Dictionary, 

DCL1-84 

deallocating drives • Files and Devices, 3-20 
default format • Files and Devices, 5-2 
defining shareable volume • DCL Dictionary, 
DCL1-247 

defining structure level • DCL Dictionary, 
DCL1-247 

directory space allocation • DCL Dictionary, 
DCL1-243 

disabling operator status • DCL Dictionary, 
DCL2-40 

dismounting • DCL Dictionary, DCL1-170 
dismounting volume set • DCL Dictionary, 
DCL1-172 

displaying quota* DCL Dictionary, DCL2-317 
enabling operator status • DCL Dictionary, 
DCL2-40 

establishing operational status for* DCL 
Dictionary, DCL2-123 
file 

copying • Files and Devices, 5-1 
See also COPY command 
copying to magnetic tape • Files and Devices, 
4-15 

file characteristics 

modifying • Files and Devices, 4-10 
files 

comparing • DCL Dictionary, DCL1-151 
deleting • DCL Dictionary, DCL1-131 
index file placement • DCL Dictionary, DCL1-245 
indicating bad block data • DCL Dictionary, 
DCL1-247 

modifying RMS defaults for file operations • DCL 
Dictionary, DCL2-214 
mounting • Files and Devices, 3-8 
See also MOUNT command 
protection • Using VMS, 7—11; Files and Devices, 
2-6 

renaming directory • DCL Dictionary, DCL2-34 
renaming file • DCL Dictionary, DCL2-34 
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Disk (Cont.) 

specifying cluster size • DCL Dictionary, 
DCL1-242 

specifying default file extension size • DCL 
Dictionary, DCL1-244 

specifying density • DCL Dictionary, DCL1-242 
specifying faulty areas • DCL Dictionary, 
DCL1-241 

specifying maximum file number • DCL Dictionary, 
DCL1-245 
structure 

Files-11 • Files and Devices, 1-5 
volume initialization • DCL Dictionary, DCL1-240 
volume protection 

See also Protection 
access types • Files and Devices, 2-5 
volume set 

See Volume set 
Disk file protection 

defining default* DCL Dictionary, DCL1-244 
Disk quota • Files and Devices, 4—8 
displaying • DCL Dictionary, DCL2-317 
Disk structure 

Files-11 • Files and Devices, A-1 
Disk volume 
See also Volume 
Dismount 

clusterwide • DCL Dictionary, DCL1-171 
disk* DCL Dictionary, DCL1-170 
magnetic tape • DCL Dictionary, DCL1-170 
shared device • DCL Dictionary, DCL1-171 
DISMOUNT command • Files and Devices, 3-18, 
3-20; DCL Dictionary, DCL1-170 to DCL1-173 
/FOREIGN qualifier • Files and Devices, 3—19 
magnetic tape • Files and Devices, 4-16 
/NOUNLOAD qualifier • Files and Devices, 3-18 
/UNIT qualifier • Files and Devices, 3-18 
Dismounting 

foreign volumes • Files and Devices, 3-19 
volumes • Files and Devices, 3-18 
Display 

allocated device • DCL Dictionary, DCL2-265 
command procedure • DCL Dictionary, DCL2-237 
date • DCL Dictionary, DCL2-328 
device status • DCL Dictionary, DCL2-264 
file at terminal • DCL Dictionary, DCL2-389 
file on current output device • DCL Dictionary, 
DCL2-389 

files opened by the system • DCL Dictionary, 
DCL2-266 

names of installed files • DCL Dictionary, 
DCL2-265, DCL2-266 


Display (Cont.) 

names of open files • DCL Dictionary, DCL2-265 
time • DCL Dictionary, DCL2-328 
working set limit • DCL Dictionary, DCL2-335 
working set quota • DCL Dictionary, DCL2-335 
.DISPLAY APPENDIX command • DSR Ref, 2-16 
.DISPLAY CHAPTER command • Text Processing, 
3-33; DSR Ref, 2-18 

.DISPLAY ELEMENTS command • Text Processing, 
3-10; DSR Ref, 2-20 

Displaying EVE command list* Text Processing, 1-35 
Displaying information • Mail, MAIL-1 
Displaying text 

/BRIEF qualifier • EDT Ref, EDT-119 
/NOTYPE qualifier • EDT Ref, EDT-153 
<null> • EDT Ref, EDT-154 
SET LINES • EDT Ref, EDT-181 
SET NUMBERS • EDT Ref, EDT-184 
SET SCREEN • EDT Ref, EDT-190 
SET TRUNCATE • EDT Ref, EDT-201 
SHL (shift left) • EDT Ref, EDT-309 
SHOW LINES • EDT Ref, EDT-219 
SHOW TRUNCATE • EDT Ref, EDT-234 
SHOW WRAP • EDT Ref, EDT-239 
SHR (shift right) • EDT Ref, EDT-310 
TYPE • EDT Ref, EDT-251 
.DISPLAY LEVELS command • Text Processing, 

3-32; DSR Ref, 2-22 

.DISPLAY NUMBER command* Text Processing, 
3-34; DSR Ref, 2-24 
/DISPLAY qualifier • EVE Ref, 1-10 
.DISPLAY SUBPAGE command • DSR Ref, 2-25 
Distribution lists • Mail, MAIL-6, MAIL-57 
creating in MAIL • Using VMS, 1-29 
DLWC (default lowercase) command • EDT Ref, 
EDT-281 

DMOV (default move) command • EDT Ref, EDT-282 
DO command • EVE Ref, EVE-43 to EVE-44 
Document conversion 

output formats • DCL Dictionary, DCL1-66 
Document formatting • DSR Ref, 1-1 
DO function 

See also ENTER 

on LK201 keyboard • EDT Ref, EDT-61 
Do key 

EDT • Text Processing, 2-16 
entering commands (EVE) • Text Processing, 1-6 
on VT200- and VT300-series terminals • Using 
VMS, 8-4 

recalling command with (EVE) • Text Processing, 
1-7 

using • Using VMS, 8-6 
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Dollar sign ($) 

and DECK command • DCL Dictionary, DCL1-111 
and EOD command • DCL Dictionary, DCL1-206 
and EOJ command • DCL Dictionary, DCL1-208 
including as data • Command Procedures, 3—5 
in command procedure • Command Procedures, 
1-2 

DOS-11 volume • Files and Devices, 5-3, 5-10 
Double tape mark • Files and Devices, B-3 
DOWN arrow key • DCL Concepts, 2-8 
See also Cursor movement 
keypad mode • EDT Ref, EDT-63 
moving the cursor with • Text Processing, 1-8 
nokeypad mode • EDT Ref, EDT-283 
recalling commands with • Using VMS, 1-18, 

1-21; DCL Concepts, 2-6 
/DOWN qualifier • DSR Ref, 4-12 
DSR (DIGITAL Standard Runoff) • DCL Dictionary, 
DCL2-63; DSR Ref, 1-1 
adjusting page numbers with • Using VMS, 9—13 
adjusting running heads with • Using VMS, 9-13, 
9-16 

.APPENDIX command • Text Processing, 3-36 
.BLANK command • Text Processing, 3-3, 3-12, 
3-22, 3-26 

.BREAK command • Text Processing, 3-12 
.CENTER command • Text Processing, 3-3 
centering text with • Using VMS, 9-5 
.CHAPTER command • Text Processing, 3-33 
creating bolded text with • Using VMS, 9-12 
creating section heads with • Using VMS, 9—14 
.DATE command • Text Processing, 3-38, 3-42 
.DISPLAY CHAPTER command • Text Processing, 
3—33 

.DISPLAY ELEMENTS command • Text 
Processing, 3-10 

.DISPLAY LEVELS command • Text Processing, 
3-32 

.DISPLAY NUMBER command • Text Processing, 
3-34 

.END FOOTNOTE command • Text Processing, 
3-44 

.END LIST command • Text Processing, 3-6, 3-12 
.END LITERAL command • Text Processing, 3-12 
.END NOTE command • Text Processing, 3-43 
.ENTRY command • Text Processing, 3-52 
.FIGURE command • Text Processing, 3-22, 3-23, 
3-26 

.FIGURE DEFERRED command • Text 
Processing, 3-22, 3-24, 3-26 
.FILL command • Text Processing, 3-14 
.FIRST TITLE command • Text Processing, 3-42 


DSR (DIGITAL Standard Runoff) (Cont.) 
flags • Using VMS, 9-1 

.FOOTNOTE command • Text Processing, 3-44 
formatting footnotes with • Using VMS, 9-12 
formatting literal text with • Using VMS, 9—7 
formatting notes with • Using VMS, 9-11 
formatting paragraphs with • Using VMS, 9-6 
.HEADER LEVEL command • Text Processing, 
3-29, 3-42 

.HEADERS ON command • Text Processing, 3-37 
.INDENT command • Text Processing, 3-19 
indenting text with • Using VMS, 9-5 
.INDEX command • Text Processing, 3-52 
Indexing Utility • DSR Ref, 6-1 
invoking • DCL Dictionary, DCL2-63 
.JUSTIFY command • Text Processing, 3-14 
justifying text with • Using VMS, 9-4 
.LEFT MARGIN command • Text Processing, 3-12 
.LIST command • Text Processing, 3-6, 3-12 
.LIST ELEMENT command • Text Processing, 3-6, 
3—12 

.LITERAL command • Text Processing, 3-12, 

3-22, 3-25, 3-26 

.NO AUTOSUBTITLE command • Text Processing, 
3-42 

.NO FILL command • Text Processing, 3-15 
.NO JUSTIFY command • Text Processing, 3-16 
.NO NUMBER command • Text Processing, 3-37 
.NOTE command • Text Processing, 3-43 
output file • Using VMS, 9-3 
printing • Using VMS, 9-20 
.PAGE SIZE command • Text Processing, 3-17 
processing source file with • Using VMS, 9-17 
producing an index with • Using VMS, 9-18 
producing table of contents with • Using VMS, 
9-17 

RUNOFF command • Text Processing, 3-4, 3-5, 
3—6 

RUNOFF/INDEX command • Text Processing, 

3-53 

source file • Using VMS, 9-1 
.SUBTITLE command • Text Processing, 3-38, 
3-39 

suspending page numbers with • Using VMS, 9-17 
Table of Contents Utility • DSR Ref, 5-1 
.TAB STOPS command • Text Processing, 3-12 
terminator • Text Processing, 3-3 
.TITLE command • Text Processing, 3-37, 3-38, 
3-42 

underlining text with • Using VMS, 9-12 
DSR commands 

abbreviating • Using VMS, 9-1 


Index-23 





Index 


i 


DSR commands (Cont.) 
defaults • DSR Ref, 1-5 
definition of • DSR Ref, 1-1 
example • DSR Ref, 1-2 
listed by function • DSR Ref, A-1 
parts of • DSR Ref, 1-2 
DSR flags 

definition of • DSR Ref, 1-1 
DSR Indexing Utility 
See also Indexing 
definition of • DSR Ref, 1-1 
DSR Table of Contents Utility • Using VMS, 9-17 
definition of • DSR Ref, 1-1 
DTE commands • DCL Dictionary, DCL2-158 
CLEAR • DCL Dictionary, DCL2-158 
EXIT • DCL Dictionary, DCL2-159 
QUIT* DCL Dictionary, DCL2-160 
SAVE • DCL Dictionary, DCL2-161 
SEND BREAK • DCL Dictionary, DCL2-162 
SET DTE • DCL Dictionary, DCL2-163 
SHOW DTE • DCL Dictionary, DCL2-168 
SPAWN • DCL Dictionary, DCL2-169 
Dual-pathed device specification • DCL Concepts, 
3-6 
Dump 
format 

byte *DCL Dictionary, DCL1-175 
decimal • DCL Dictionary, DCL1-175 
hexadecimal • DCL Dictionary, DCL1-176 
longword • DCL Dictionary, DCL1-176 
octal • DCL Dictionary, DCL1-176 
word *DCL Dictionary, DCL1-177 
of files • DCL Dictionary, DCL1-174 
of volumes* DCL Dictionary, DCL1-174 
reading • DCL Dictionary, DCL1-174 
DUMP command • DCL Dictionary, DCL1-174 to 
DCL1-178 

DUPC (default uppercase) command ♦ EDT Ref, 
EDT-284 
Duplicate labels 

command interpreter rules for • DCL Dictionary, 
DCL1-52, DCL1-227, DCL1-229 
/DUPLICATE qualifier • EDT Ref, EDT-137 
with COPY • EDT Ref, EDT-125 
/DUPLICATES qualifier • Sort/Merge, SORT-25 


E 


EBCDIC 

collating sequence • Using VMS, 1-39 


/ECHO qualifier* VMS Intro, 6-14 
EDIT/ACL command • Using VMS, 7-15; DCL 
Dictionary, DCL1-179 

EDIT command • VMS Intro, 2-4; Using VMS, 8-47; 
Mail, MAIL—44 

EDT editor • Text Processing, 2-2 
EDIT/EDT command • DCL Dictionary, DCL1-180 to 
DCL1-183 

/READ_ONLY qualifier to • Using VMS, 2-15 
EDIT/FDL command* DCL Dictionary, DCL1-184 
Editing buffers 

editing two files within two buffers (EVE) • Text 
Processing, 1-56 
Editing files 

using two buffers (EVE) • Text Processing, 1-56 
Editing messages • Mail, MAIL-19 
Editing session • EDT Ref, EDT-1 
EDT editor 

changing modes • Text Processing, 2-6 
exiting from EDT • Using VMS, 8-48; Text 
Processing, 2-3 

invoking EDT • Text Processing, 2-2 
recovering EDT after system interruption • 
Using VMS, 8-54; Text Processing, 2-6, 
2-36 

refreshing screen display • Using VMS, 8-53 
EVE editor* Text Processing, 1-1 

beginning with existing file name • Text 
Processing, 1-2 

beginning with new file name • Text 
Processing, 1-1 

beginning without file name • Text Processing, 
1-3 

changing modes • Text Processing, 1-12 
customizing* Text Processing, 1-71, 1-75 
ending session • Using VMS, 8-3; Text 
Processing, 1-3 

recovering EVE after system interruption • 
Using VMS, 8-23 

refreshing screen display • Using VMS, 8-23; 

Text Processing, 1-38 
saving text • Text Processing, 1-3 
Editing the command line 

enabling line editing • DCL Concepts, 2-4 
insert mode • DCL Concepts, 2-4 
line editing keys • DCL Concepts, 2-5 
overstrike mode • DCL Concepts, 2-4 
Edit mode 

changing* EDT Ref, EDT-49, EDT-122, 

EDT-180, EDT-287 

displaying • EDT Ref, EDT-218, EDT-220 
keypad • EDT Ref, EDT-2 
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Edit mode (Cont.) 

line • EDT Ref, EDT-5 
nokeypad • EDT Ref, EDT-6 
setting • EDT Ref, EDT-183 
Editor 

See also EDT editor 

See also EVE editor 

default • DCL Dictionary, DCL1—180 

invoking • Mail, MAIL-52 

EDT • DCL Dictionary, DCL1-180 
EVE • DCL Dictionary, DCL1-189 
SUMSLP • DCL Dictionary, DCL1-185 
TECO • DCL Dictionary, DCL1-186 
VAXTPU • DCL Dictionary, DCL1-189 
screen oriented • DCL Dictionary, DCL1—180 
EVE • DCL Dictionary, DCL1-189 
VAXTPU • DCL Dictionary, DCL1-189 
/EDIT qualifier • Mail, MAIL-13, MAIL-20 
EDIT/SUM command • DCL Dictionary, DCL1-185 
EDIT/TECOcommand* DCL Dictionary, DCL1-186 
to DCL1-188 

EDIT/TPU command • Using VMS, 8-2; DCL 
Dictionary, DCL1-189 to DCL1-204; EVE 
Ref, 1-5 

/COMMAND qualifier* EVE Ref, 1-8, 1-38 
/CREATE qualifier • EVE Ref, 1-9 
/DEBUG qualifier* EVE Ref, 1-9 
/DISPLAY qualifier • EVE Ref, 1-10 
EVE editor* Text Processing, 1-2, 1-78 
/INITIALIZATION qualifier • EVE Ref, 1-11, 1-33 
/INTERFACE qualifier • EVE Ref, 1-12 
invoking EVE with • Text Processing, 1-1 
/JOURNAL qualifier • EVE Ref, 1-12, 1-23 
/MODIFY qualifier* EVE Ref, 1-13 
/NOJOURNAL qualifier* EVE Ref, 1-23 
/OUTPUT qualifier* EVE Ref, 1-14 
/READ_ONLY • Using VMS, 2-15 
/READ_ONLY qualifier • EVE Ref, 1-14 
/RECOVER qualifier* EVE Ref, 1-15 

with buffer-change journal file • EVE Ref, 1-21 
with keystroke journal file • EVE Ref, 1-23 
/SECTION qualifier • EVE Ref, 1-16, 1-36 
/SECTION qualifier (EVE) • Text Processing, 1-76 
/START_POSITION qualifier • EVE Ref, 1-18 
/WORK qualifier • EVE Ref, 1-18 
/WRITE qualifier* EVE Ref, 1-19 
EDT conversion • EVE Ref, 1-39 

equivalent commands • EVE Ref, A—1 
EDT description* DCL Dictionary, DCL1-180 
EDT editor • EDT Ref, EDT-1 

as default MAIL editor* Using VMS, 1-35 
boldfacing text with DSR • Text Processing, 3-46 


EDT editor (Cont.) 
buffer 

commands for using • Using VMS, 8-69 to 
8-71 

definition • Using VMS, 8-47 
changing modes in • Using VMS, 8-52 
copying text • Text Processing, 2-30 
creating a file with • EDT Ref, EDT-1 
creating macros • Text Processing, 2-48 
creating startup file for* Using VMS, 8—71 
cursor control in • Using VMS, 8-54, 8—58 
defining keys • Text Processing, 2-44, 2-46, 2-48 
defining macros in • Using VMS, 8-74 
deleting text* Text Processing, 2-14, 2-27 
displaying a file with • Using VMS, 8-48 
exiting from • Using VMS, 8-48; Text Processing, 
2-3 

finding text • Text Processing, 2-16 
indenting text • Text Processing, 2-42 
inserting text • Text Processing, 2-10, 2-24, 2-36 
invoking* Using VMS, 8-47; Text Processing, 
2-2; EDT Ref, EDT-1 
key definitions 

assigning • Using VMS, 8-71, 8-73 
keypad commands • Using VMS, 8-49 
line-editing commands • Using VMS, 8-48, 8-52 
modes of editing • Text Processing, 2-2, 2-6 
moving text • Text Processing, 2—18, 2-29, 2-36 
reading a file • Using VMS, 8-69 
recovering session after system interruption • 
Using VMS, 8-54 

recovering text from journal file • Text Processing, 
2-36 

replacing text • Using VMS, 8-64; Text 
Processing, 2-20, 2-28, 2-30 
restoring text* Text Processing, 2-14 
setting screen display in • Using VMS, 8-72 
tabbing facility • Text Processing, 2-37 
writing buffer to a file • Text Processing, 2-36 
writing text to a file • Using VMS, 8-69 
EDTINI.EDT file • Using VMS, 8-71; EDT Ref, 
EDT-7 

EDT keypad • EVE Ref, EVE-170 
EDT keypad option 

EVE • Using VMS, 8-23 
EVE editor* Text Processing, 1-6 
online help for (EVE) • Text Processing, 1-36 
EDT macros 

creating • EDT Ref, EDT-11 
Ellipsis (...) wildcard 

in a directory name • Using VMS, 2-23 to 2-24; 
DCL Concepts, 3-10 
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Ellipsis (...) wildcard (Cont.) 

in output directory specifications • DCL Concepts, 

3- 20 

.ELSE command • DSR Ref, 2-66 
ELSE keyword 

and IF command • DCL Dictionary, DCL1-237 
Emphasizing text 

bolding • DSR Ref, 2-29, 2-32, 2-43, 2-51, 3-6, 

4- 5, 4-6, A-3 

index entries • DSR Ref, 6-3 
inserting notes • DSR Ref, 2-86 
methods for • DSR Ref, 4-5 
overstriking • DSR Ref, 3-14, 4-5 
underlining • DSR Ref, 2-34, 2-56, 3-19, 4-5, 
4-20, 4-22, 4-25, A-3 
.ENABLE BAR command • DSR Ref, 2-26 
.ENABLE BOLDING command • DSR Ref, 2-29 
.ENABLE HYPHENATION command • DSR Ref, 2-30 
.ENABLE INDEXING command • DSR Ref, 2-31 
.ENABLE OVERSTRIKING command • DSR Ref, 
2-32 

.ENABLE TOC command • DSR Ref, 2-33 
.ENABLE UNDERLINING command • DSR Ref, 2-34 
•END BAR command • DSR Ref, 2-26 
.END FOOTNOTE command • Text Processing, 3-44; 
DSR Ref, 2-58 

•ENDIF command • DSR Ref, 2-66 
.END LIST command • Text Processing, 3-6, 3-12; 
DSR Ref, 2-79 

.END LITERAL command • Text Processing, 3-12 
.END NOTE command • Text Processing, 3-43; 

DSR Ref, 2-86 

End of batch job on cards • DCL Dictionary, 
DCL1-208 

End of data stream • DCL Dictionary, DCL1-206 
See also EOD command 
End-of-file condition • DCL Dictionary, DCL1-206 
End-of-file indicator* DCL Dictionary, DCL1-111 
END OF LINE command • Using VMS, 8-9; EVE 
Ref, EVE-45 

moving the cursor with (EVE) • Text Processing, 
1-8 

End-of-module 

record analysis* DCL Dictionary, DCL1-27 
End-of-tape marker 
See EOT marker 

.END SUBPAGE command • DSR Ref, 2-119 
ENDSUBROUTINE command • Using VMS, 6-26; 

DCL Dictionary, DCL1-53, DCL1-54, DCL1-205 
ENLARGE WINDOW command • Using VMS, 8-35; 
EVE Ref, EVE—46 
EVE editor* Text Processing, 1-55 


ENTER • EDT Ref, EDT-64 
ENTER command • Using VMS, 8-53 
Entering commands 

COMMAND • EDT Ref, EDT-28 

Ctrl/Z • EDT Ref, EDT-129, EDT-273 

DEFINE MACRO • EDT Ref, EDT-133 

DESEL (deactivate select) • EDT Ref, EDT-280 

DO • EDT Ref, EDT-61 

ENTER • EDT Ref, EDT-64 

EXT (extend) • EDT Ref, EDT-288 

/QUERY qualifier* EDT Ref, EDT-159 

RESET • EDT Ref, EDT-88 

using the count specifier 

nokeypad mode • EDT Ref, EDT-274 
Enter key 

EDT • Text Processing, 2-16 
EVE editor* Text Processing, 1-12 
Entity specifier 

nokeypad mode • EDT Ref, EDT-285 
with APPEND • EDT Ref, EDT-261 
with CHGC (change case) • EDT Ref, EDT-266 
with CHGL (change case lower) • EDT Ref, 
EDT-267 

with CHGU (change case upper) • EDT Ref, 
EDT-268 

with CUT • EDT Ref, EDT-275 
with D (delete) • EDT Ref, EDT-276 
with FILL • EDT Ref, EDT-289 
with “move” • EDT Ref, EDT-296 
with R (replace) • EDT Ref, EDT-302 
with TADJ (tab adjust) • EDT Ref, EDT-317 
.ENTRY command • Text Processing, 3-52; DSR 
Ref, 2-35, 4-8 

EOB (end-of-buffer) symbol • Using VMS, 8-47 
EOD command • Using VMS, 6-6; Command 
Procedures, 3-5; DCL Dictionary, DCL1-206 
to DCL1-207 

and DECK command • DCL Dictionary, DCL1-111 
EOF (end-of-file) label • Files and Devices, B-3, B-16 
EOJ command • DCL Dictionary, DCL1-208 
EOL command • Using VMS, 8-55 
EOL keypad function 

EDT • Text Processing, 2-11 
EOL keypad function (EDT) • EDT Ref, EDT-66 
See also Cursor movement 
EOT (end-of-tape) marker • Files and Devices, B-2 
EOV (end-of-volume) label • Files and Devices, B-3, 
B-16 

.EQ. 

in a numeric comparison • DCL Concepts, 6-7 
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.EQS. 

in a string comparison • DCL Concepts, 6-2 
Equal key 

default order •Sort/Merge, SORT-71 
Equal sign (=) 
buffer specifier 

line mode • EDT Ref, EDT-120 
nokeypad mode • EDT Ref, EDT-265 
Equal to operator 

symbol for in expressions • Command Procedures, 
2-13 

Equivalence name • VMS Intro, 3-9 

assigning to logical name • DCL Dictionary, 
DCL1-39, DCL1-114 

definition • Using VMS, 4-1; DCL Concepts, 4-2 
displaying for logical names • DCL Dictionary, 
DCL2-329 
Equivalence string 

definition • Command Procedures, 2-1 
ERASE CHARACTER command • Using VMS, 8-13; 
EVE Ref, EVE-47 

erasing text with (EVE) • Text Processing, 1-15 
ERASE command • Mail, MAIL-46 
ERASE LINE command • Using VMS, 8-13; EVE 
Ref, EVE-48 

erasing text with (EVE) • Text Processing, 1-15 
ERASE PREVIOUS WORD command • Using VMS, 
8-13; EVE Ref, EVE-49 
erasing text with (EVE) • Text Processing, 1-15 
ERASE START OF LINE command • EVE Ref, 
EVE-50 

erasing text with (EVE) • Text Processing, 1-15 
ERASE WORD command • EVE Ref, EVE-51 
erasing text with (EVE) • Text Processing, 1-16 
Erasing text 

EVE editor* Text Processing, 1-19 
Error 
checking 

controlling • DCL Dictionary, DCL2-182 
locating with SET VERIFY • Command 
Procedures, 3-12 
reporting 

for image files* DCL Dictionary, DCL1-22 
for object files • DCL Dictionary, DCL1-26 
Error condition 

determining severity level • Command Procedures, 
7-2 

Error handling 

disabling Ctrl/Y • Command Procedures, 7-6 
disabling error checking • Command Procedures, 
7-5 

handling I/O errors • Command Procedures, 6-10 


Error handling (Cont.) 

in command procedures • Using VMS, 6-30 
specifying actions for different severity levels • 
Command Procedures, 7-4 
with ON command • Command Procedures, 7-4 
Error message 

description of* VMS Intro, 1-7 
example • DSR Ref, 4-2, 4-15 
format • Using VMS, 1-19 
in DSR • DSR Ref, 1-1 
Error stream 

defining for created process • DCL Dictionary, 
DCL2-53 
Escape character 

inserting (EVE) • Text Processing, 1-13 
Escape sequences 

European • DSR Ref, B-4 
module names • DSR Ref, B-4 
standard • DSR Ref, B-4 
EVE$INIT.EVE file • EVE Ref, 1-24, 1-32 
EVE$INIT logical name • DCL Dictionary, DCL1-194; 

EVE Ref, 1-11, 1-24, 1-32 
EVE attributes 

saving in command file • Text Processing, 1-77 
saving in section file • Text Processing, 1-73 
EVE command file 
See Command file 
EVE command line 

correcting mistakes on • Text Processing, 1-6 
EVE commands 

ATTACH • Text Processing, 1-67 
BOTTOM • Text Processing, 1-8 
BOX COPY • Text Processing, 1-22,1-23 
BOX CUT* Text Processing, 1-22,1-23 
BOX CUT INSERT* Text Processing, 1-22,1-24 
BOX CUT OVERSTRIKE • Text Processing, 1-22, 
1-24 

BOX PASTE* Text Processing, 1-22, 1-23 
BOX PASTE INSERT* Text Processing, 1-22, 
1-24 

BOX PASTE OVERSTRIKE • Text Processing, 
1-22, 1-24 

BOX SELECT • Text Processing, 1-22 
BUFFER • Text Processing, 1-47 
CAPITALIZE WORD • Text Processing, 1-39 
CENTER LINE • Text Processing, 1-39 
CHANGE DIRECTION • Text Processing, 1-8 
CHANGE MODE* Text Processing, 1-12 
COPY • Text Processing, 1-19 
CUT • Text Processing, 1-19 
DELETE • Text Processing, 1-15 
DELETE BUFFER* Text Processing, 1-47 
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EVE commands (Cont.) 

DELETE WINDOW • Text Processing, 1-55 
END OF LINE • Text Processing, 1-8 
ENLARGE WINDOW • Text Processing, 1-55 
ERASE CHARACTER • Text Processing, 1-15 
ERASE LINE • Text Processing, 1-15 
ERASE PREVIOUS WORD • Text Processing, 
1-15 

ERASE START OF LINE* Text Processing, 1-15 
ERASE WORD • Text Processing, 1-16 
EXIT • Text Processing, 1-3 
EXTEND EVE* Text Processing, 1-70 
EXTEND THIS* Text Processing, 1-70 
FILL* Text Processing, 1-39 
FILL PARAGRAPH • Text Processing, 1-39 
FILL RANGE • Text Processing, 1-40 
FIND • Text Processing, 1-26 
FIND NEXT • Text Processing, 1-26 
FIND SELECTED • Text Processing, 1-26 
FORWARD • Text Processing, 1-9 
GET FILE • Text Processing, 1-47 
GO TO • Text Processing, 1-32, 1-47 
HELP • Text Processing, 1-35 
INCLUDE FILE* Text Processing, 1-12, 1-47 
INSERT HERE • Text Processing, 1-18 
INSERT MODE* Text Processing, 1-12 
INSERT PAGE BREAK • Text Processing, 1-40 
LEARN • Text Processing, 1-61 
LINE • Text Processing, 1-9 
LOWERCASE WORD* Text Processing, 1-40 
MARK • Text Processing, 1-32 
MOVE BY LINE • Text Processing, 1-9 
MOVE BY PAGE • Text Processing, 1-9 
MOVE BY WORD • Text Processing, 1-9 
NEW • Text Processing, 1-48 
NEXT BUFFER • Text Processing, 1-48 
NEXT SCREEN • Text Processing, 1-9 
NEXT WINDOW* Text Processing, 1-9, 1-55 
ONE WINDOW • Text Processing, 1-55 
OPEN ♦ Text Processing, 1-47 
OPEN SELECTED* Text Processing, 1-48 
OVERSTRIKE MODE • Text Processing, 1-13 
PAGINATE* Text Processing, 1-40 
PASTE • Text Processing, 1-18 
PREVIOUS SCREEN • Text Processing, 1-9 
PREVIOUS WINDOW • Text Processing, 1-9, 
1-55 

QUIT • Text Processing, 1-3 
QUOTE • Text Processing, 1-13 
RECOVER BUFFER* Text Processing, 1-37 
RECOVER BUFFER ALL* Text Processing, 1-37 
REMOVE • Text Processing, 1-19, 1-48 


EVE commands (Cont.) 

REPEAT • Text Processing, 1-7 
RESET • Text Processing, 1-19 
RESTORE • Text Processing, 1-16 
RESTORE BOX SELECTION • Text Processing, 
1-22, 1-25 

RESTORE CHARACTER* Text Processing, 1-16 
RESTORE LINE* Text Processing, 1-16 
RESTORE SELECTION • Text Processing, 1-16, 
1-19, 1-25 

RESTORE WORD • Text Processing, 1-16 
REVERSE* Text Processing, 1-9 
SAVE ATTRIBUTES* Text Processing, 1-60, 
1-61, 1-65, 1-72, 1-73, 1-76 
SAVE EXTENDED EVE • Text Processing, 1-60, 
1-61, 1-65, 1-73 

SAVE FILE • Text Processing, 1-48 
SAVE FILE AS • Text Processing, 1-48 
SAVE SYSTEM ATTRIBUTES • Text Processing, 
1-72 

SELECT • Text Processing, 1-19, 1-48 
SELECT ALL* Text Processing, 1-19 
SET BOX NOPAD • Text Processing, 1-22, 1-25 
SET BOX NOSELECT • Text Processing, 1-22, 
1-24 

SET BOX PAD* Text Processing, 1-22, 1-25 
SET BOX SELECT • Text Processing, 1-22, 1-24 
SET BUFFER • Text Processing, 1-48 
SET CURSOR BOUND* Text Processing, 1-10 
SET CURSOR FREE • Text Processing, 1-10 
SET DEFAULT COMMAND FILE • Text 
Processing, 1-73, 1-77 

SET DEFAULT SECTION FILE • Text Processing, 
1-73, 1-76 

SET EXIT ATTRIBUTE CHECK • Text Processing, 
1-73 

SET FIND CASE EXACT • Text Processing, 1-26 
SET FIND CASE NOEXACT • Text Processing, 
1-26 

SET FIND NOWHITESPACE • Text Processing, 
1-26 

SET FIND WHITESPACE • Text Processing, 1-26 
SET GOLD KEY • Text Processing, 1-59 
SET JOURNALING* Text Processing, 1-37 
SET JOURNALING ALL* Text Processing, 1-37 
SET LEFT MARGIN • Text Processing, 1-40 
SET NODEFAULT COMMAND FILE • Text 
Processing, 1-73 

SET NODEFAULT SECTION FILE • Text 
Processing, 1-73, 1-76 
SET NOEXIT ATTRIBUTE CHECK • Text 
Processing, 1-73; EVE Ref, EVE-53, 
EVE-105 
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EVE commands (Cont.) 

SET NOGOLD KEY • Text Processing, 1-59 
SET NOJOURNALING • Text Processing, 1-37 
SET NOJOURNALING ALL* Text Processing, 
1-37 

SET NOPENDING DELETE • Text Processing, 
1-19 

SET NOSECTION FILE PROMPTING • Text 
Processing, 1-73, 1-76, 1-78 
SET NOSHIFT KEY • Text Processing, 1-59 
SET NOWRAP • Text Processing, 1-41 
SET PARAGRAPH INDENT • Text Processing, 
1-40 

SET PENDING DELETE • Text Processing, 1-19 
SET RIGHT MARGIN • Text Processing, 1-40 
SET SCROLL MARGINS • Text Processing, 1-10 
SET SECTION FILE PROMPTING • Text 
Processing, 1-73, 1-76 
SET SHIFT KEY • Text Processing, 1-59 
SET TABS AT • Text Processing, 1-40 
SET TABS EVERY • Text Processing, 1-40 
SET TABS INSERT • Text Processing, 1-40 
SET TABS INVISIBLE • Text Processing, 1-41 
SET TABS MOVEMENT* Text Processing, 1-41 
SET TABS SPACES • Text Processing, 1-41 
SET TABS VISIBLE • Text Processing, 1-41 
SET WIDTH • Text Processing, 1-56 
SET WILDCARD ULTRIX • Text Processing, 1-26 
SET WILDCARD VMS • Text Processing, 1-26 
SET WRAP • Text Processing, 1-41 
SHIFT LEFT* Text Processing, 1-10, 1-56 
SHIFT RIGHT* Text Processing, 1-10, 1-56 
SHOW • Text Processing, 1-48 
SHOW BUFFERS* Text Processing, 1-48 
SHOW DEFAULTS BUFFERS • Text Processing, 
1-49 

SHOW SYSTEM BUFFERS • Text Processing, 
1-49 

SHOW WILDCARDS • Text Processing, 1-26 
SHRINK WINDOW* Text Processing, 1-56 
SPAWN • Text Processing, 1-67 
SPLIT WINDOW • Text Processing, 1-56 
START OF LINE • Text Processing, 1-10 
STORE TEXT* Text Processing, 1-19 
TOP • Text Processing, 1-10 
TPU • Text Processing, 1-68 
TWO WINDOWS • Text Processing, 1-56 
UNDEFINE KEY* Text Processing, 1-61 
UPPERCASE WORD • Text Processing, 1-41 
WILDCARD FIND • Text Processing, 1-26 
WRITE FILE • Text Processing, 1-49 


EVE editing keys 

Ctrl/A* Text Processing, 1-12 
Ctrl/E • Text Processing, 1-8 
Ctrl/H • Text Processing, 1-8 
Ctrl/I • Text Processing, 1-39 
Ctrl/J • Text Processing, 1-14 
Ctrl/L* Text Processing, 1-39 
Ctrl/M • Text Processing, 1-39 
Ctrl/U • Text Processing, 1-14 
Ctrl/V • Text Processing, 1-12 
Delete key* Text Processing, 1-14 
down arrow • Text Processing, 1-8 
Find key • Text Processing, 1-27 
GOLD—* • Text Processing, 1-8 
GOLD-F13* Text Processing, 1-15 
GOLD-lnsert Here • Text Processing, 1-15 
GOLD-Next Screen • Text Processing, 1-8, 1-55 
GOLD-Prev Screen • Text Processing, 1-8, 1-55 
GOLD-Remove • Text Processing, 1-18 
GOLD-Select • Text Processing, 1-18 
Insert Here • Text Processing, 1-18 
left arrow • Text Processing, 1-8 
Remove • Text Processing, 1-18 
Return • Text Processing, 1-39 
right arrow • Text Processing, 1-8 
Select* Text Processing, 1-18 
Tab • Text Processing, 1-39 
up arrow • Text Processing, 1-8 
EVE editor 

abbreviating commands • Text Processing, 1-7 
adjusting margins with • Using VMS, 8-26 
as default MAIL editor* Using VMS, 1-35 
assigning multiple definitions to a key • Text 
Processing, 1-62 

batch editing • DCL Dictionary, DCL1-191, 
DCL1-194 
buffer 

commands for using • Using VMS, 8-31 to 
8-33 

definition • Using VMS, 8-2 
reading file into • Using VMS, 8-34 
writing • Using VMS, 8-34 
buffer-change journaling • Text Processing, 1-36 
centering text with • Using VMS, 8-30 
changing case of text with • Using VMS, 8-30 
copying text* Text Processing, 1-21 
creating a scratchpad • Text Processing, 1-50 
creating buffers* Text Processing, 1-52 
creating command symbol for • Text Processing, 
1-3 

creating subprocess* Text Processing, 1-67 
cursor control in • Using VMS, 8-8 
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EVE editor (Cont.) 

customizing editing sessions • Text Processing, 
1-75 

DECwindows interface • DCL Dictionary, 

DCL1-193, DCL1-195 
defining keys • Text Processing, 1-60 
defining keys to execute a command • Text 
Processing, 1-60 

defining keys with LEARN • Text Processing, 1-61 
editing command lines* Text Processing, 1-6 
editing modes • Using VMS, 8-7 
entering commands • Using VMS, 8-6; Text 
Processing, 1-4, 1-7 

erasing text* Text Processing, 1-14, 1-19 
exiting from • Using VMS, 8-3 
extending • Text Processing, 1-69 
filling text in • Using VMS, 8-29 
finding text • Text Processing, 1-26 
formatting text • Using VMS, 8-24; Text 
Processing, 1-39 

getting started with • Text Processing, 1-1 
in insert mode • Using VMS, 8-11 
initialization file • DCL Dictionary, DCL1-194 
in overstrike mode • Using VMS, 8-11 
input file • DCL Dictionary, DCL1-189, DCL1-192 
inserting text* Text Processing, 1-12, 1-20 
invoking • DCL Dictionary, DCL1-189 
journaling • DCL Dictionary, DCL1-195, DCL1-198 
key definitions 

assigning • Using VMS, 8-39 to 8-40, 8-40, 
8—41 

removing • Using VMS, 8-40 
keypad diagram 

for VT100-series terminal • Using VMS, 8-6 
for VT200- and VT300-series terminals • 

Using VMS, 8-4 

keystroke journaling • Text Processing, 1-37 
leaving subprocess • Text Processing, 1-67 
marking locations • Using VMS, 8-19; Text 
Processing, 1-31 

modes of editing • Text Processing, 1-2 
moving text • Text Processing, 1-18 
moving the cursor* Text Processing, 1-8 
output file • DCL Dictionary, DCL1-197 
reaching DCL* Text Processing, 1-67 
reading batch job log file with • Using VMS, 3-9 
reading file into buffer* Text Processing, 1-54 
recalling commands • Text Processing, 1-7 
recovering session after system interruption • 

Using VMS, 8-23 

recovery from system failure • DCL Dictionary, 
DCL1-198 


EVE editor (Cont.) 

removing key definitions • Text Processing, 1-61 
replacing text • Using VMS, 8-20; Text 
Processing, 1-14, 1-33 
section file • DCL Dictionary, DCL1-200 
setting margins* Text Processing, 1-41 
spawning out of • Using VMS, 8-46 
start position • DCL Dictionary, DCL1-202 
using buffers • Text Processing, 1-47 
using windows • Text Processing, 1-55 
window • Using VMS, 8-35 
definition • Using VMS, 8-2 
writing VAXTPU procedure for • Text Processing, 
1-69 

EVE initialization file 

See also Initialization file 
saving attributes in • Text Processing, 1-78 
EVE keypad options 
See Keypad 
EVE section file 

See also Section file 

saving attributes in • Text Processing, 1-73 
EVE source code • Text Processing, 1-69 
EX (exit to line mode) command • EDT Ref, EDT-287 
EXAMINE command* DCL Concepts, 7-1, 7-4; 

DCL Dictionary, DCL1-209 to DCL1-211 
and DEPOSIT command • DCL Dictionary, 
DCL1-147 

length qualifier • DCL Dictionary, DCL1-210 
EXCHANGE command • DCL Dictionary, DCL1-212 
EXCHANGE/NETWORK command • DCL Dictionary, 
DCL1-213 to DCL1-221 
creating files • DCL Dictionary, DCL1-217 
protecting files • DCL Dictionary, DCL1-217 
qualifiers • DCL Dictionary, DCL1-217 
selecting transfer modes • DCL Dictionary, 
DCL1-215 

transferring files • DCL Dictionary, DCL1-215 
wildcard character • DCL Dictionary, DCL1-216 
Exchange Utility (EXCHANGE) • Files and Devices, 
5-1, 5-10 

DCL level • Files and Devices, 5-11 
DIRECTORY command • Files and Devices, 5-11 
exiting from • Files and Devices, 5-11 
invoking • Files and Devices, 5-11 
MOUNT command • Files and Devices, 5-11 
Exclamation point (!) 

as comment character • Command Procedures, 

1-3 

Executable image 
See also Image 

creating • DCL Dictionary, DCL1-387 
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Executable image (Cont.) 

patching • DCL Dictionary, DCL2-11 
EXECUTE access 
See also Access 

for a directory • DCL Concepts, 8-8 
for a file • DCL Concepts, 8-9 
for a global section • DCL Concepts, 8-10 
for a queue • DCL Concepts, 8-7 
for a volume • DCL Concepts, 8-7 
Execute access category 
definition • Using VMS, 7-4 
Execute procedure (@) command • Command 
Procedures, 1-5 

executing command procedure interactively with • 
Using VMS, 6-2 

executing EVE initialization file with • Using VMS, 
8—44 

executing nested command procedure with • Using 
VMS, 6-26 

@ (execute procedure) command • DCL Dictionary, 
DCL1-9 to DCL1-13 

Executing SYS$LOGIN • DCL Dictionary, DCL1-392 
Execution 

of alternate login command procedure • DCL 
Dictionary, DCL1-393 

of login command procedure • DCL Dictionary, 
DCL1-392 
resuming 

command procedure • DCL Dictionary, 
DCL1-63 

DCL commands • DCL Dictionary, DCL1-63 
program • DCL Dictionary, DCL 1-63 
Execution of command procedure on remote node • 
Command Procedures, 1-6 
Execution queue • DCL Dictionary, DCL1-251 
Executive mode 

See also Access mode 
/EXECUTIVE.MODE qualifier 

ASSIGN command* DCL Dictionary, DCL1-40 
EXIT command* VMS Intro, 1-14, 1-17; Using 
VMS, 1-21, 6-4, 8-3, 8-48; Mail, MAIL-1, 
MAIL-47; Command Procedures, 5-16; DCL 
Dictionary, DCL1-222 to DCL1-225; EDT Ref, 
EDT-138; EVE Ref, EVE-52 to EVE-53 
See also STOP command 
EDT • Text Processing, 2-3 
EVE editor • Text Processing, 1-3 
Exiting 

from PHONE • Phone, PHONE-3, PHONE-12 
Expiration date field • Files and Devices, 4-16, B-12 
Expression 

See also Numeric expression 


Expression (Cont.) 

See also Operand 
See also Operator 
See also String expression 
character • Using VMS, 5-12 
definition • Using VMS, 5-11; DCL Concepts, 5-7 
iterative substitution • DCL Concepts, 7-6 
logical • Using VMS, 5-15 
logical operators • DCL Concepts, 6-8 
numeric • Using VMS, 5-13 
numeric comparison operators • DCL Concepts, 
6-7 

numeric operators • DCL Concepts, 6-7 
rules for determining the value • Using VMS, 5-18; 
DCL Concepts, 6-12 

string comparison operators* Using VMS, 5-11; 

DCL Concepts, 6-2 
string operators • DCL Concepts, 6-2 
summary of operators* Using VMS, 5-18; DCL 
Concepts, 6-10 

value test • DCL Dictionary, DCL1—237 
Expression evaluation 

definition • DCL Concepts, 7-4 
EXT (extend) command • EDT Ref, EDT-288 
See also Entering commands 
EXTEND ALL command • EVE Ref, EVE-54 
EXTEND EVE command 

using to compile VAXTPU procedures • Text 
Processing, 1-70 

EXTEND EVE command/BEGIN • EVE Ref, EVE-55 
EXTEND EVE command/END • EVE Ref, EVE-56 
EXTEND THIS command • EVE Ref, EVE-57 
EVE editor* Text Processing, 1-70 
EXTEND TPU command • EVE Ref, EVE-58 
See also EXTEND EVE command 
Extensible VAX Editor 
See EVE editor 
Extent* Files and Devices, 1-2 
EXTRACT command • VMS Intro, 1-14; Using VMS, 
1-31; Mail, MAIL-3, MAIL-48 


F 


F$CONTEXT lexical function • DCL Dictionary, 
DCL1-272, DCL1-275 to DCL1-279 
F$CSID lexical function • DCL Dictionary, DCL1-272, 
DCL1-280 to DCL1-281 
FSCVSI lexical function • Command Procedures, 

B—1; DCL Dictionary, DCL1-272, DCL1-282 to 
DCL1-283 
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F$CVTIME lexical function • Command Procedures, 
B—1; DCL Dictionary, DCL1-273, DCL1-284 to 
DCL1-285 

F$CVUI lexical function • Command Procedures, B-1; 
DCL Dictionary, DCL1-273, DCL1-286 

F$DEVICE lexical function • DCL Dictionary, 
DCL1-273, DCL1-287 to DCL1-288 
use of • DCL Dictionary, DCL1-287 
value returned • DCL Dictionary, DCL1-287 

F$DIRECTORY lexical function • Command 

Procedures, B-1; DCL Dictionary, DCL1-273, 
DCL1-289 

F$EDIT lexical function • Command Procedures, 

B-1; DCL Dictionary, DCL1-273, DCL1-290 to 
DCL1-291 

F$ELEMENT lexical function • Using VMS, 6-25; 
Command Procedures, B-1; DCL Dictionary, 
DCL1-273, DCL1-292 to DCL1-293 
with F$EXTRACT • Command Procedures, 4-9 

F$ENVIRONMENT lexical function • Using VMS, 
6-34; Command Procedures, B-1; DCL 
Dictionary, DCL1-273, DCL1-294 to DCL1-296 
obtaining current default • Command Procedures, 
4-3 

F$EXTRACT lexical function • Using VMS, 6-24, 
6-29; Command Procedures, B-1; DCL 
Dictionary, DCL1-273, DCL1-297 to DCL1-298 
extracting a string • Command Procedures, 4-9 

F$FAO lexical function • Command Procedures, 

B-1; DCL Dictionary, DCL1-273, DCL1-299 to 
DCL1-305 

defining record fields • Command Procedures, 

4-11 

F$FILE_ATTRIBUTES lexical function • Command 
Procedures, B-1; DCL Dictionary, DCL1-273, 
DCL1-306 to DCL1-308 

F$GETDVI lexical function • Command Procedures, 
B-1; DCL Dictionary, DCL1-273, DCL1-309 to 
DCL1-321 

item names • DCL Dictionary, DCL1-310 

F$GETJPI lexical function • Using VMS, 6-33; 
Command Procedures, B-1; DCL Dictionary, 
DCL1-273, DCL1-322 to DCL1-327 

F$GETQUI lexical function • Command Procedures, 
B-1; DCL Dictionary, DCL1-273, DCL1-328 to 
DCL1-343 

obtaining queue information • Command 
Procedures, 4-5 

F$GETSYI lexical function • Command Procedures, 
B-2; DCL Dictionary, DCL1-273, DCL1-344 to 
DCL1-348 

obtaining system or cluster information • Command 
Procedures, 4-5 


F$IDENTIFIER lexical function • Command 

Procedures, B-2; DCL Dictionary, DCL1-273, 
DCL1-349 to DCL1-350 

F$INTEGER lexical function • DCL Concepts, 6-11; 
Command Procedures, B-2; DCL Dictionary, 
DCL1-273, DCL1-351 

converting data type • Command Procedures, 
4-13 

evaluating data • Command Procedures, 4-13 

F$LENGTH lexical function • VMS Intro, 5-8; 
Command Procedures, B-2; DCL Dictionary, 
DCL1-273, DCL1-352 

with F$LOCATE • Command Procedures, 4-9 

F$LOCATE lexical function • Command Procedures, 
B-2; DCL Dictionary, DCL1-273, DCL1-353 to 
DCL1-354 

with F$LENGTH • Command Procedures, 4-9 

F$LOGICAL 

See F$TRNLNM 

F$LOGICAL lexical function 

See also F$TRNLNM lexical function 

F$MESSAGE lexical function • Command 

Procedures, B-2; DCL Dictionary, DCL1-273, 
DCL1-355 

F$MODE lexical function • Command Procedures, 
B-2; DCL Dictionary, DCL1-274, DCL1-356 to 
DCL1-357 

F$PARSE lexical function • Command Procedures, 
B-2; DCL Dictionary, DCL1-274, DCL1-358 to 
DCL1-360 

F$PID lexical function • Command Procedures, B-2; 
DCL Dictionary, DCL1-274, DCL1-361 to 
DCL1-362 

obtaining process identification • Command 
Procedures, 4-5 

F$PRIVILEGE lexical function ♦ Command 

Procedures, B-2; DCL Dictionary, DCL1-274, 
DCL1-363 

F$PROCESS lexical function • Command 

Procedures, B-2; DCL Dictionary, DCL1-274, 
DCL1-364 

F$SEARCH lexical function • Using VMS, 6-14; 
Command Procedures, B-2; DCL Dictionary, 
DCL1-274, DCL1-365 to DCL1-367 

avoiding command procedure errors • Command 
Procedures, 4-7 

searching for a file • Command Procedures, 4-7 

F$SETPRV lexical function • Command Procedures, 
B-2; DCL Dictionary, DCL1-274, DCL1-368 to 
DCL1-371 

F$STRING lexical function • DCL Concepts, 6-11; 
Command Procedures, B—3; DCL Dictionary, 
DCL1-274, DCL1-372 
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F$STRING lexical function (Cont.) 

converting data type • Command Procedures, 

4-13 

F$TIME lexical function • Command Procedures, B-3; 

DCL Dictionary, DCL1-274, DCL1-373 
FSTRNLNM lexical function • Command Procedures, 
B-3; DCL Dictionary, DCL1-274, DCL1-374 to 
DCL1-377 

translating logical names • Command Procedures, 

4- 8 

F$TYPE lexical function • DCL Concepts, 6-11; 
Command Procedures, B-3; DCL Dictionary, 
DCL1-378 to DCL1-379 
F$USER lexical function • Command Procedures, 
B-3; DCL Dictionary, DCL1-274, DCL1-380 
F$VERIFY lexical function • Command Procedures, 
B-3; DCL Dictionary, DCL1-274, DCL1-381 to 
DCL1-382 

changing VERIFY state • Command Procedures, 

3— 13 

F10 key • DCL Concepts, 2-8 
FI 2 key 

See also BACKSPACE 
on LK201 keyboard • EDT Ref, EDT-22 
FI 3 key 

See also LINEFEED 
on LK201 keyboard • EDT Ref, EDT-79 
F6 key • DCL Concepts, 2-7 
F6 through FI 4 keys • Using VMS, 1-17 to 1-19; 

DCL Concepts, 2-5 to 2-6 
FAB (file access block) • Files and Devices, B-14 
False expression 

and IF command • DCL Dictionary, DCL1-237 
FHM (file highwater mark) • DCL Dictionary, 
DCL1-244 

/FIELD qualifier • Sort/Merge, SORT-62 
.FIGURE command • Text Processing, 3-22, 3-23, 
3-26; DSR Ref, 2-36 

.FIGURE DEFERRED command • Text Processing, 
3-22, 3-24, 3-26; DSR Ref, 2-36 
Figures 

formatting • DSR Ref, A-3 
example • DSR Ref, 2-37 
File 

See also Directory file 
carriage control in • Using VMS, 2-5 
copying • VMS Intro, 6-8; Using VMS, 2-16 
between nodes • Using VMS, 2-16 
with access control string • Using VMS, 2-19 
copying from magnetic tape • Files and Devices, 

5- 3 

copying to magnetic tape • Files and Devices, 

4- 15 


File (Cont.) 

creating • VMS Intro, 2-4; Files and Devices, 1-6; 
EVE Ref, 1-9 

creating in command procedure • Using VMS, 

6-13 

definition • VMS Intro, 2-1; Using VMS, 2-1 
deleting • VMS Intro, 2-4 
displaying • VMS Intro, 2-5 
editing • EVE Ref, 1-13 

editing in command procedure • Using VMS, 6-15 
formatting text 
See DSR 

identifier field • Files and Devices, B-10 
including in conversation • Phone, PHONE-13 
indexed • Files and Devices, 1-6 
listing • VMS Intro, 2-6 
merging • Using VMS, 1-42 

and sequence checking • Using VMS, 1-42 
multiple • Using VMS, 1-37 
name • VMS Intro, 2-1 

nonstandard format* Files and Devices, 4-2, 4-13 
open file quota • Using VMS, 6-33 
operations over the network • Using VMS, 2-14 
output • EVE Ref, 1-14, 1-19 
printing • VMS Intro, 2-7 
privileges • Files and Devices, 2-8 
protecting • VMS Intro, 2-8; Mail, MAIL-12 
purging • VMS Intro, 2-5; Using VMS, 2-17 
reading from command procedure • Using VMS, 
6-15 

renaming • VMS Intro, 2-7; Using VMS, 2-17 
reserved 

list of • Files and Devices, A-1 
sorting • Using VMS, 1-37 
type • VMS Intro, 2-2 
version • VMS Intro, 2-3 
volume configurations • Files and Devices, B-3, 
B-4, B-5, B-7 

writing in command procedure • Using VMS, 6-13 
File access 

See also Access 

and ownership categories • Using VMS, 7-4 
on disk • Using VMS, 2-9; Files and Devices, 
4-13; DCL Concepts, 3-5 
on tape • Using VMS, 2-9; Files and Devices, 
4-13; DCL Concepts, 3-5 
File attributes 

specifying • Sort/Merge, SORT-43 
File characteristic • Using VMS, 2-4 to 2-5 
record • Using VMS, 2-4 
size • Using VMS, 2-5 
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FILE command • Using VMS, 1-33; Mail, MAIL-10, 
MAIL-50 

See also MOVE command 
File expiration date 

specifying retention time values • DCL Dictionary, 
DCL2-242 
File extension size 

changing default • DCL Dictionary, DCL2-240 
File header • Files and Devices, 1-5 
description of 'Files and Devices, 1-6 
Files-11 structure • Files and Devices, A-2 
File header label 
See Header label 

File highwater mark* DCL Dictionary, DCL1-244 
File image 

analyzing • DCL Dictionary, DCL1-22 
fixup section analysis • DCL Dictionary, DCL1-23 
File name 

See also File name field 
ANSI • Files and Devices, 4-18 
changing ♦ DCL Dictionary, DCL2-34 
definition • Using VMS, 2-2 
rules for entering • Using VMS, 2-2; DCL 
Concepts, 3-13 

valid characters • DCL Concepts, 3-13 
valid characters in • Using VMS, 2-2 
VMS • Files and Devices, 4-18 
File name field 

default value • Using VMS, 2-12; DCL Concepts, 
3-22 

definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
rules for using an asterisk (*) wildcard ♦ Using 
VMS, 2-14; DCL Concepts, 3-18,3-19 
rules for using a percent sign (%) wildcard • Using 
VMS, 2-15; DCL Concepts, 3-19 
with a null value • DCL Concepts, 3-16 
File object 

analyzing • DCL Dictionary, DCL1-26 
analyzing debugger information records • DCL 
Dictionary, DCL1-27 

analyzing global symbol directory records • DCL 
Dictionary, DCL1-27 

analyzing link option specification records • DCL 
Dictionary, DCL1-28 
analyzing module header records • DCL 
Dictionary, DCL1-28 

analyzing module traceback records • DCL 
Dictionary, DCL1-28 

analyzing relocation records • DCL Dictionary, 
DCL1-29 

analyzing text ’DCL Dictionary, DCL1-29 


File object (Cont.) 

identifying errors • DCL Dictionary, DCL1-26 
File organization 

See also Indexed file 
See also Relative file 
See also Sequential file 

specifying output from SORT/MERGE operation • 
Using VMS, 1-41 

File protection • Using VMS, 7-9; Files and Devices, 
2-8 

See also Protection 
access types • DCL Concepts, 8-9 
changing default • DCL Concepts, 8-9 
changing default for volume • DCL Dictionary, 
DCL2-240 

commands for setting • DCL Concepts, 8-9 
defining at file creation • DCL Dictionary, DCL1-85 
defining default • DCL Dictionary, DCL1-244 
displaying default • DCL Concepts, 8-9 
displaying for a specific file • DCL Concepts, 8-9 
establishing default • DCL Dictionary, DCL2-199 
how default is determined • DCL Concepts, 8-9 
modifying • DCL Dictionary, DCL2-196 
with EXCHANGE/NETWORK command • DCL 
Dictionary, DCL1-217 

Files 

allocating headers* DCL Dictionary, DCL1-244 
appending to • DCL Dictionary, DCL1-34 
batch job 

deleting after processing • DCL Dictionary, 
DCL2-379 

closing* DCL Dictionary, DCL1-58 
comparing • DCL Dictionary, DCL1-151 
concatenating • DCL Dictionary, DCL1-74 
copying* DCL Dictionary, DCL1-74, DCL1-213 
creating • DCL Dictionary, DCL1-74, DCL1-84, 
DCL1-213 

with EDT editor* DCL Dictionary, DCL1-180 
with EVE* DCL Dictionary, DCL1-189, 
DCL1-192 

with TECO editor* DCL Dictionary, DCL1-186 
with VAXTPU • DCL Dictionary, DCL1-189, 
DCL1-192 

creating owner UIC • DCL Dictionary, DCL1-85 
deassigning logical name • DCL Dictionary, 
DCL1-58 

default extension size on disk • DCL Dictionary, 
DCL1-244 

deleting • DCL Dictionary, DCL1-131 
displaying 

allocated blocks* DCL Dictionary, DCL1-164 
at terminal • DCL Dictionary, DCL2-389 
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Files 

displaying (Cont.) 

backup date • DCL Dictionary, DCL1-161 
blocks used • DCL Dictionary, DCL1-164 
creation date*DCL Dictionary, DCL1-161 
expiration date • DCL Dictionary, DCL1-161 
files opened by the system • DCL Dictionary, 
DCL2-266 

help • DCL Dictionary, DCL1-231 
latest version • DCL Dictionary, DCL1-165 
modification date • DCL Dictionary, DCL1-161 
names of installed files • DCL Dictionary, 
DCL2-265, DCL2-266 
names of open files • DCL Dictionary, 
DCL2-265 

on current output device • DCL Dictionary, 
DCL2-389 

owner UIC • DCL Dictionary, DCL1-163 
protection • DCL Dictionary, DCL1-163 
dumping • DCL Dictionary, DCL1-174 
editing 

with EDT editor* DCL Dictionary, DCL1-180 
with EVE*DCL Dictionary, DCL1-189, 
DCL1-197 

with SUMSLP editor • DCL Dictionary, 
DCL1-185 

with TECO editor • DCL Dictionary, DCL1-186 
with VAXTPU • DCL Dictionary, DCL1-189, 
DCL1-197 

extending • DCL Dictionary, DCL1-36 
ignoring characters in comparisons • DCL 
Dictionary, DCL1-154 

ignoring records in comparisons • DCL Dictionary, 
DCL1-154 

ignoring strings in comparisons • DCL Dictionary, 
DCL1-154 
input 

EVE • DCL Dictionary, DCL1-189 
VAXTPU • DCL Dictionary, DCL1-189 
installed 

displaying names of • DCL Dictionary, 
DCL2-266 

list in directory • DCL Dictionary, DCL1-159 
maximum number on disk • DCL Dictionary, 

DCL1-245 
modifying 

characteristics of • DCL Dictionary, DCL2-144 
queue entry for • DCL Dictionary, DCL2-136 
RMS defaults for file operations • DCL 
Dictionary, DCL2-214 
opening • DCL Dictionary, DCL2-5 
output 

EVE • DCL Dictionary, DCL1-197, DCL1-203 


Files 

output (Cont.) 

VAXTPU* DCL Dictionary, DCL1-197, 
DCL1-203 

printing • DCL Dictionary, DCL2-13 

purging • DCL Dictionary, DCL2-24 

reading records from • DCL Dictionary, DCL2-28 

recovering in EVE* Text Processing, 1-37 

renaming • DCL Dictionary, DCL2-34 

restricted 

access to • DCL Dictionary, DCL2-236 
searching for character string • DCL Dictionary, 
DCL2-81 

transferring • DCL Dictionary, DCL1-213 
unlocking • DCL Dictionary, DCL2-395 
updating 

with SUMSLP editor* DCL Dictionary, 

DCL1-185 
version limit 

defining at directory creation • DCL Dictionary, 
DCL1-90 

writing records to • DCL Dictionary, DCL2-399 
Files-11 disk 

Exchange Utility (EXCHANGE) • Files and 
Devices, 5-3, 5-10 

initializing • DCL Dictionary, DCL1-240 
structure • Files and Devices, 1-2, A-1 
Level 1 • Files and Devices, 5-2 
Level 2 • Files and Devices, 5-2 
reserved files • Files and Devices, A-1 
structure levels compared • Files and Devices, A-3 
Files-11 On-Disk Structure Level 1 • DCL Dictionary, 
DCL1-240 
Files-11 volume 

modifying characteristics of • DCL Dictionary, 
DCL2-240 

File section number field • Files and Devices, B-12 
File sequence number field • Files and Devices, B-12 
File-set identifier field • Files and Devices, B-12 
File shareable image 

analyzing • DCL Dictionary, DCL1-22 
File specification • VMS Intro, 3-1; Files and 
Devices, B-10 
See also Device 
See also Directory name 
See also File name field 
See also File type field 
See also File version number field 
See also Node field 
See also Wildcard character 
alternate form for magnetic tapes ♦ DCL Concepts, 
3-16 
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File specification (Cont.) 

ANSI • Fires and Devices, 4-18 

as a parameter value • DCL Concepts, 1-6 

as a qualifier value • DCL Concepts, 1-10 

See also Output file specifications for 
qualifiers 

as a search list • Using VMS, 4-15; DCL 
Concepts, 4-20 

as multiple search lists • DCL Concepts, 4-21 
default values • DCL Concepts, 3-22 

created by logical name translation • Using 
VMS, 4-13 

in output file specification • Using VMS, 2-13 
default values created by logical name translation • 
DCL Concepts, 4-13 to 4-14 
device field in • Using VMS, 2-11 
directory • Using VMS, 2-11 
example • Using VMS, 2-11; DCL Concepts, 3-1 
file name • Using VMS, 2-11; DCL Concepts, 
3-13 

file type • Using VMS, 2-11; DCL Concepts, 3-14 
file version number • Using VMS, 2-11; DCL 
Concepts, 3-15 
foreign • Using VMS, 2-12 
format • Using VMS, 2-11; DCL Concepts, 3-1, 
3-13 

in parameter list • Using VMS, 2-13 

list of included fields • DCL Concepts, 3-1 

logical name in • Using VMS, 4-1 

node field in • Using VMS, 2-11 

node name • Using VMS, 2-11; DCL Concepts, 

3- 2 

node name in • Using VMS, 2-16 
rules for entering • DCL Concepts, 3-1 to 3-2 
File specification specifier 
See also SHOW FILES 
with EXIT • EDT Ref, EDT-138 
with HELP • EDT Ref, EDT-179 
with INCLUDE • EDT Ref, EDT-147 
with PRINT • EDT Ref, EDT-157 
with SET COMMAND • EDT Ref, EDT-173 
with WRITE • EDT Ref, EDT-253 
File system requests 

responding to • DCL Dictionary, DCL2-39 
File type 

BIX • DSR Ref, 6-6 

BRN • DSR Ref, 4-14, 5-1, 5-2, 6-1, 6-6 

BTC • DSR Ref, 5-1, 5-2 

changing • DCL Dictionary, DCL2-34 

default • Command Procedures, 1-2; DSR Ref, 

4- 17, 5-2 

definition • Using VMS, 2-2; DCL Concepts, 3-14 


File type (Cont.) 

list of default • Using VMS, 2-2 
LNI • DSR Ref, 4-9, B-1 
MEC • DSR Ref, 5-3 
MEX • DSR Ref, 6-4, 6-6 
RNO • DSR Ref, 5-2 
RNT • DSR Ref, 5-2 
RNX • DSR Ref, 6-1, 6-6 
rules for entering • Using VMS, 2-2; DCL 
Concepts, 3-14 

File type field • Files and Devices, B-10 

default values • Using VMS, 2-12; DCL Concepts, 
3-14, 3-22 

default values created by logical name translation • 
Using VMS, 4-13; DCL Concepts, 4-13 
definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
rules for using an asterisk (*) wildcard • Using 
VMS, 2-14; DCL Concepts, 3-18, 3-19 
rules for using a percent sign (%) wildcard • Using 
VMS, 2-15; DCL Concepts, 3-19 
with a null value • DCL Concepts, 3-16 
File version number 

changing • DCL Dictionary, DCL2-34 
definition • Using VMS, 2-3 
format in a file specification • DCL Concepts, 3-15 
File version number field 

default value • Using VMS, 2-12; DCL Concepts, 
3-22 

definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
rules for using an asterisk (*) wildcard • Using 
VMS, 2-14; DCL Concepts, 3-18, 3-19 
File windows 

mapping pointer allocation • DCL Dictionary, 
DCL1-248 

specifying mapping pointers • DCL Dictionary, 
DCL2-242 

FILL command • Using VMS, 8-29, 8-36, 8-67, 8-68 
See also Formatting, text 
EVE editor* Text Processing, 1-43 
formatting text with (EVE) • Text Processing, 1-39 
keypad mode • EDT Ref, EDT-67 
line mode • EDT Ref, EDT-141 
nokeypad mode • EDT Ref, EDT-289 
using with search string (EVE) • Text Processing, 
1-20 

with paragraph indent • EVE Ref, EVE-203 
.FILL command • Text Processing, 3-14; DSR Ref, 
2-39 

FILL command/BEGIN • EVE Ref, EVE-59 
FILL command/END • EVE Ref, EVE-60 


Index-36 






Index 


FILL keypad function 

EDT • Text Processing, 2-21 
FILL PARAGRAPH command • Using VMS, 8-29, 
8—38 

EVE editor* Text Processing, 1-44 
formatting text with (EVE) • Text Processing, 1-39 
FILL PARAGRAPH command/BEGIN • EVE Ref, 
EVE-61 

FILL PARAGRAPH command/END • EVE Ref, 
EVE-61 

FILL RANGE command • Using VMS, 8-36 

formatting text with (EVE) • Text Processing, 1-40 
using with search string (EVE) • Text Processing, 
1-20 

FILL RANGE command/BEGIN • EVE Ref, EVE-62 
FILL RANGE command/END • EVE Ref, EVE-62 
FIND command • Using VMS, 8-62; EVE Ref, 
EVE-63 to EVE-65 
EVE editor • Text Processing, 1-27 
finding text with (EVE) • Text Processing, 1-26 
keypad mode • EDT Ref, EDT-69 
line mode • EDT Ref, EDT-143 
See also Locating text 
specifying direction of search (EVE) • Text 
Processing, 1-30 
Find key 

EVE editor* Text Processing, 1-27 
on LK201 keyboard • EDT Ref, EDT-69 
on VT200- and VT300-series terminals • Using 
VMS, 8-17 

VT100 terminal, equivalent of* Using VMS, 8-17 
FIND keypad function 

EDT • Text Processing, 2-16 
FIND NEXT command • EVE Ref, EVE-66 to 
EVE-67 

after a REPLACE command • EVE Ref, EVE-120 
after a WILDCARD FIND command • EVE Ref, 
EVE-246 

EVE editor • Text Processing, 1-28 
finding text with (EVE) • Text Processing, 1-26 
using with search string (EVE) • Text Processing, 
1-20 

FIND SELECTED command • EVE Ref, EVE-68 
EVE editor • Text Processing, 1-29 
finding text with (EVE) • Text Processing, 1-26 
using with search string (EVE) • Text Processing, 
1-20 

FIRST command • Mail, MAIL-52 
.FIRST TITLE command • Text Processing, 3-42; 
DSR Ref, 2-40 

Fixed-length record • Files and Devices, B-13 


Fixed-length records 

specifying • Sort/Merge, SORT-43 
Fixup section 

analyzing • DCL Dictionary, DCL1-23 
Flag 

Accept • DSR Ref, 3-5 
Bold • DSR Ref, 3-6 
Break • DSR Ref, 3-7 
Capitalize • DSR Ref, 3-8, 6-2 
Case control • DSR Ref, 3-8 
Comment • DSR Ref, 3-9 
Control • DSR Ref, 3-10 
Hyphenate • DSR Ref, 3-11 
Index • DSR Ref, 3-12 
in DSR source file • Using VMS, 9-1 
Lowercase • DSR Ref, 3-13 
Overstrike • DSR Ref, 3-14 
Period • DSR Ref, 3-15 
Space • DSR Ref, 3-16 
Subindex • DSR Ref, 3-17 
Substitute • DSR Ref, 3-18 
Underline • DSR Ref, 3-19 
Uppercase • DSR Ref, 3-20, 6-2 
Flag character 

default • DSR Ref, 3-4 
enabling • DSR Ref, 3-3 
literal translation of • DSR Ref, 3-5 
pairing • DSR Ref, 3-6, 3-18, 3-19, 3-20 
redefining • DSR Ref, 3-3 
Flag recognition • DSR Ref, 3-2, A-5 
enabling • DSR Ref, 2-42 
.FLAGS ACCEPT command • DSR Ref, 2-41 
.FLAGS BOLD command • DSR Ref, 2-43 
.FLAGS BREAK command • DSR Ref, 2-44 
.FLAGS CAPITALIZE command • DSR Ref, 2-45 
.FLAGS COMMENT command • DSR Ref, 2-46 
.FLAGS CONTROL command • DSR Ref, 2-47 
.FLAGS HYPHENATE command • DSR Ref, 2-48 
.FLAGS INDEX command • DSR Ref, 2-49 
.FLAGS LOWERCASE command • DSR Ref, 2-50 
.FLAGS OVERSTRIKE command • DSR Ref, 2-51 
.FLAGS PERIOD command • DSR Ref, 2-52 
.FLAGS SPACE command • DSR Ref, 2-53 
.FLAGS SUBINDEX command • DSR Ref, 2-54 
.FLAGS SUBSTITUTE command • DSR Ref, 2-55 
.FLAGS UNDERLINE command • DSR Ref, 2-56 
.FLAGS UPPERCASE command • DSR Ref, 2-57 
FNDNXT command • Using VMS, 8-63; EDT Ref, 
EDT-71 

FNDNXT keypad function 
EDT • Text Processing, 2-16 
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Folders • Mail, MAIL-88 

changing the name of • Mail, MAIL-98 
copying messages to • Mail, MAIL-32 
creating • Mail, MAIL-10 
default* VMS Intro, 1-12; Mail, MAIL-9 
deleting • Mail, MAIL-12 
displaying • Mail, MAIL-11 
modifying • Mail, MAIL-10 
moving messages to • Mail, MAIL-39 
NEWMAIL folder • Mail, MAIL-69 
searching for text in • Mail, MAIL-75 
selecting • Mail, MAIL-11 
using to organize messages • Mail, MAIL-9 
wastebasket • Mail, MAIL-66, MAIL-83 
FONT command • DCL Dictionary, DCL1-226 
Font definitions 

LN01 laser printer • DSR Ref, 4-10 
LNI file • DSR Ref, B-3 
loading • DSR Ref, B-4 

command procedure for • DSR Ref, B-4 

Font kit 

installing • DSR Ref, B-2 
LN01 • DSR Ref, B-1 
Footnote 

See also Text formatting 
creating with DSR • Text Processing, 3-44 
formatting with DSR • Using VMS, 9-12 
inserting in text • DSR Ref, A-3 
.FOOTNOTE command • DSR Ref, 2-58 
Foreign command • Using VMS, 5-1; DCL Concepts, 
5—1 

definition • Using VMS, 1-7; DCL Concepts, 5-8 
parsing in a command line • DCL Concepts, 5-8 
syntax • DCL Concepts, 5-8 
Foreign file specification 

on a network • Using VMS, 2-12; DCL Concepts, 
3-3 

Foreign volume 

mounting • Files and Devices, 3-8 
See also MOUNT command 

Format 

ANSI-labeled volume • Files and Devices, B-1 
/FORMAT qualifier • Sort/Merge, SORT-37, SORT-43 
Formatting 

See also Text formatting 
document • DSR Ref, 1-1 
figures • DSR Ref, A-3 
index • DSR Ref, A-4 
lists • DSR Ref, A-3 

of DIFFERENCES output • DCL Dictionary, 
DCL1-155 


Formatting (Cont.) 
text 

breaking terms logically • DSR Ref, 3-7 
Ctrl/F • EDT Ref, EDT-67 
example • DSR Ref, 2-4 
.KEEP • DSR Ref, 2-73 
.LAYOUT • DSR Ref, 2-75 
.NO SPACE • DSR Ref, 2-84 
FILL • EDT Ref, EDT-67, EDT-141, EDT-289 
FILLSR. • EDT Ref, EDT-67 
indexing • DSR Ref, 6-4 
RESEQUENCE • EDT Ref, EDT-167 
/SEQUENCE qualifier* EDT Ref, EDT-170 
SET TRUNCATE • EDT Ref, EDT-201 
SET WRAP • EDT Ref, EDT-204 
TAB • EDT Ref, EDT-103 
TAB ADJUST • EDT Ref, EDT-249 
table of contents • DSR Ref, 5-3 
Form feed • EDT Ref, EDT-40 
in DSR output • Using VMS, 9-20 
/FORM_SIZE qualifier • DSR Ref, 4-13 
FORTRAN carriage control • Using VMS, 2-5 
FORTRAN command • VMS Intro, 4-7 
FORWARD command* VMS Intro, 1-12; Mail, 
MAIL-53; EVE Ref, EVE-69 
moving the cursor with (EVE) • Text Processing, 
1-9 

Found range 

definition (EVE) • Text Processing, 1-26 
Free cursor movement* EVE Ref, EVE-155 
with EDT keypad • EVE Ref, EVE-172 
with the MOVE DOWN command • EVE Ref, 
EVE-87 

with the MOVE LEFT command • EVE Ref, 
EVE-88 

with the MOVE RIGHT command • EVE Ref, 
EVE-89 

with the MOVE UP command • EVE Ref, EVE-90 
with WPS keypad • EVE Ref, EVE-186 
Function keys • VMS Intro, 1-1; Using VMS, 1-17 
to 1-19; DCL Concepts, 2-5 to 2-6, 2-7 to 
2-8 

on LK201 keyboard • EDT Ref, EDT-4, EDT-130 


G 


.GE. 

in a numeric comparison • DCL Concepts, 6-7 
Generation version number* Files and Devices, B-12 
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Generic device name • DCL Dictionary, DCL1-15 
definition • Using VMS, 2-10; DCL Concepts, 3-6 
Generic queue • DCL Dictionary, DCL1-251 
definition • Using VMS, 2-18 
initializing • DCL Dictionary, DCL1-257, DCL2-350 
.GES. 

in a string comparison • DCL Concepts, 6-2 
GET FILE command • Using VMS, 8-9, 8-31, 8-34; 

EVE Ref, EVE-70 

creating a new buffer with (EVE) • Text Processing, 
1-52 

for buffer manipulation (EVE) • Text Processing, 
1-47 

reading file into buffer with (EVE) • Text 
Processing, 1-54 
Global attributes 

See also Command file 
EVE editor* Text Processing, 1-71 
Global section 
protection 

access types • DCL Concepts, 8-10 
how to set • DCL Concepts, 8-10 
Global symbol • DCL Dictionary, DCL1-1, DCL1-5 
command levels available to • Using VMS, 5-3 
creating in command procedure • Using VMS, 

6—11 

Global symbol directory records 

analyzing in object file • DCL Dictionary, DCL1-27 
Global symbol table 

analyzing • DCL Dictionary, DCL1-23 
deleting symbols from • DCL Dictionary, 
DCL1-145 

entering symbol in • DCL Dictionary, DCL1-263 
Global variable 

in VAXTPU procedure (EVE) • Text Processing, 
1-69 

parts of (EVE) • Text Processing, 1-70 
GOLD—► 

moving the cursor with • Text Processing, 1-8 
GOLD/A • EDT Ref, EDT-30 
See also Tabbing functions 
GOLD/D • EDT Ref, EDT-34 
See also Tabbing functions 
GOLD/E • EDT Ref, EDT-35 
See also Tabbing functions 
GOLD-F13 

erasing text with • Text Processing, 1-15 
GOLD function • EDT Ref, EDT-73 
GOLD-lnsert Here 

erasing text with • Text Processing, 1-15 


GOLD key • Using VMS, 8-41; EVE Ref, EVE-166 
canceling • EVE Ref, EVE-197 
canceling key press (EVE) • Text Processing, 1-65 
creating your own key combinations for (EVE) • 
Text Processing, 1-63 
default combinations • EVE Ref, EVE-166, 
EVE-167 

defining (EVE) • Text Processing, 1-62 
defining in an initialization file (EVE) • Text 
Processing, 1-65 

in EDT • Using VMS, 8-49; Text Processing, 
2-10, 2-18 

in EVE • Using VMS, 8-41 
list of default GOLD key combinations (EVE) • Text 
Processing, 1-63 
GOLD-Next Screen 

in window environment* Text Processing, 1-55 
moving the cursor with • Text Processing, 1-8 
GOLD-Prev Screen 

in window environment* Text Processing, 1-55 
moving the cursor with • Text Processing, 1-8 
GOLD/R • EDT Ref, EDT-44 
GOLD-Remove 

moving text with • Text Processing, 1-18 
GOLD-Select 

moving text with • Text Processing, 1-18 
GOLD/T • EDT Ref, EDT-45 
See also Tabbing functions 
GOLD/U • EDT Ref, EDT-47 
See also Deleting text 
GOLD/W • EDT Ref, EDT-48 
See also Refreshing screen 
GOLD/Z • EDT Ref, EDT-49 
GOSUB command • Using VMS, 6-25; Command 
Procedures, 5-10; DCL Dictionary, DCL1-227 
to DCL1-228 

GO TO command • Using VMS, 8-19, 8-31 
GOTO command • VMS Intro, 5-6; Using VMS, 
6-22; DCL Dictionary, DCL1-229 to 
DCL1-230; EVE Ref, EVE-71 
EVE editor* Text Processing, 1-32 
for buffer manipulation (EVE) • Text Processing, 
1-47 

using (EVE) • Text Processing, 1-32 
with labels • Command Procedures, 5-9 
with the IF...THEN language construct • Command 
Procedures, 5-10 
Graphic symbol 

VT100 terminals • Using VMS, A-5 
VT200 terminals • Using VMS, A-5 
VT300 terminals • Using VMS, A-5 
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Greater than operator 

symbol for in expressions • Command Procedures, 
2-13 

Greater than or equal to operator 

symbol for in expressions • Command Procedures, 
2-13 

GROUP category 

definition • DCL Concepts, 8-3 
Group logical name table 

canceling entries • DCL Dictionary, DCL1-105 
definition • Using VMS, 4-7; DCL Concepts, 4-6 
including logical name • Using VMS, 4-7; DCL 
Concepts, 4-6; DCL Dictionary, DCL1-41, 
DCL1-116 
Group number 

in UIC • Using VMS, 7-2 
Group ownership category • Using VMS, 7-3 
GRPPRV privilege • DCL Concepts, 8-6 
GST (global symbol table) 

DCL reserved symbols • Using VMS, 5-4; DCL 
Concepts, 5-2 

definition • Using VMS, 5-3; DCL Concepts, 5-2 
in the search order • DCL Concepts, 5-3 
search order • Using VMS, 5-5 
.GT. 

in a numeric comparison • DCL Concepts, 6-7 
.GTS. 

in a string comparison • DCL Concepts, 6-2 


H 


Hanging up • Phone, PHONE-14 
HANGUP command • Phone, PHONE-3 
Hardcopy change mode* EDT Ref, EDT-122, 
EDT-183 

Hardcopy terminal • EDT Ref, EDT-232 
Hard page break 

See INSERT PAGE BREAK command 
Head 

See Running head 
Header allocation 

on disk volumes* DCL Dictionary, DCL1-244 
Header label • Files and Devices, B-3 

HDR1 label • Files and Devices, 2-4, B-10 
accessibility field • Files and Devices, B-13 
creation date field • Files and Devices, B-12 
expiration date field • Files and Devices, B-12 
file identifier field • Files and Devices, B-10 
file section number field • Files and Devices, 
B-12 


Header label 

HDR1 label (Cont.) 

file sequence number field * Files and 
Devices, B-12 

file-set identifier field • Files and Devices, 

B-12 

generation number field • Files and Devices, 
B-12 

generation version-number field • Files and 
Devices, B-12 

HDR2 label • Files and Devices, B-10, B-13 
block length field • Files and Devices, B-14 
buffer-offset length field • Files and Devices, 
B-15 

record format field • Files and Devices, B-13 
record length field • Files and Devices, B-15 
system-dependent field • Files and Devices, 
B-15 

HDR3 label • Files and Devices, B-10, B-16 

RMS attributes field • Files and Devices, B-16 
HDR4 label • Files and Devices, B-10, B-16 
information on • Files and Devices, 1-7 
on magnetic tape • Files and Devices, 4-17 
.HEADER LEVEL command • Text Processing, 3-29, 
3-42; DSRRef, 2-60 
Header levels • DSR Ref, 2-60 
See also Section headers 
displaying • DSR Ref, 5-3 
example • DSR Ref, 2-61,2-111 
indentation of numbers • DSR Ref, 5-4 
section numbers • DSR Ref, 5-5 
Header page • VMS Intro, 2-7 
.HEADERS LOWER command • DSR Ref, 2-65 
.HEADERS MIXED command • DSR Ref, 2-65 
.HEADERS ON command • Text Processing, 3-37; 
DSR Ref, 2-63 

.HEADERS UPPER command • DSR Ref, 2-65 
Help 

for a specific EVE command • Text Processing, 
1-35 

for EVE keypad diagram • Text Processing, 1-36 
HELP 

keypad mode • EDT Ref, EDT-76 
line mode • EDT Ref, EDT-145 
nokeypad mode • EDT Ref, EDT-291 
HELP command* VMS Intro, 1-8, 1-14, 1-17; 

Using VMS, 1-7, 1-27, 1-36, 8-22, 8-51; Mail, 
MAIL-1, MAIL-55; Phone, PHONE-15; DCL 
Dictionary, DCL1-231 to DCL1-236; EVE Ref, 
EVE-72 to EVE-74 

displaying command list (EVE) • Text Processing, 
1-35 
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HELP command (Cont.) 

displaying keypad diagram (EVE) • Text 
Processing, 1-36 
EDT editor • Text Processing, 2-4 
EVE editor* Text Processing, 1-35 
using abbreviations with (EVE) • Text Processing, 
1-36 

with specific command (EVE) • Text Processing, 
1-35 

HELP commands 

using to get information • EDT Ref, EDT-2 
Help display 

of default libraries* DCL Dictionary, DCL1-232 
HELP Facility • EDT Ref, EDT-2 
EDT • Using VMS, 8-51 
EVE • Using VMS, 8-22 
in interactive utilities • Using VMS, 1-8 
HELP key 

on LK201 keyboard • EDT Ref, EDT-76 
HELP KEYPAD command 

EVE editor* Text Processing, 1-62 
Help library 

creating • DCL Dictionary, DCL1-231 
user* DCL Dictionary, DCL1-234 
Hexadecimal dump* DCL Dictionary, DCL1-176 
Hexadecimal value • DCL Concepts, B-1 
Hibernation 

and RUN command • DCL Dictionary, DCL2-55 
Hierarchy 

See Directory hierarchy 
High-level language • VMS Intro, 4-2 
Hold 

placing a call on • Phone, PHONE-16 
taking a caller oft’ Phone, PHONE-20 
Home block • Files and Devices, 1-5, A-1 
$$Hours • DSR Ref, 3-18 
Hyphen (-) 

See also Continuation character 
and command line continuation • Using VMS, 
1-10; DCL Concepts, 1-4 
wildcard 

in a directory name • Using VMS, 2-24 to 
2-25; DCL Concepts, 3-12 
Hyphenate flag • DSR Ref, 3-11 
See also Text formatting 
default • DSR Ref, 3-11 
example • DSR Ref, 3-11 
recognizing • DSR Ref, 2-48 
Hyphenation • DSR Ref, 2-30, 2-48 


I_ 

I (insert) command • EDT Ref, EDT-292 
See also Inserting text 
I/O error 

in command procedures • Using VMS, 6-18 
/IDENTIFICATION qualifier • DSR Ref, 5-4, 6-7 
Identifier 

definition • Using VMS, 7-6 
IDENTIFIER access control list entry • Using VMS, 
7-8 

Identifier field 

file • Files and Devices, 4-17, B-10 
file-set • Files and Devices, B-12 
implementation • Files and Devices, B-9 
owner • Files and Devices, 3-13, B-9 
volume • Files and Devices, 3—13, 3-17, B-9 
IF command • VMS Intro, 5-6; Using VMS, 6-21; 
DCL Concepts, 7-1, 7-4, 7-6; DCL Dictionary, 
DCL1-237 to DCL1-239 
and CONTINUE command • DCL Dictionary, 
DCL1-63 

controlling execution flow • Command Procedures, 
5-6 

evaluating input of INQUIRE command • 
Command Procedures, 5-8 
executing a block of commands after • Command 
Procedures, 5-8 

restrictions to the IF-THEN-ELSE construct* 
Command Procedures, 5-6 
syntax rules for • Command Procedures, 5-6 
testing severity level • Command Procedures, 7—2 
with GOTO command • Command Procedures, 
5-10 

.IF command • DSR Ref, 2-66, A-5 
.IFNOT command • DSR Ref, 2-66 
Image • VMS Intro, 4-1 
See also Command image 
See also Foreign command 
continuing execution of • DCL Dictionary, DCL1-63 
defining base address • DCL Dictionary, 
DCL1-390 

definition • Using VMS, 3-1, 3-3 
executing in detached process • DCL Dictionary, 
DCL2-53 

executing in subprocess • DCL Dictionary, 
DCL2-53 

noncommand • Using VMS, 3-4 

resuming execution of* DCL Dictionary, DCL1-63 

running • DCL Dictionary, DCL2-51 
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Image (Cont.) 

system • DCL Dictionary, DCL1-389 
terminating with EXIT command • DCL Dictionary, 
DCL1-222 
Image file 

See also PATCH command 
analyzing • DCL Dictionary, DCL1-22 
analyzing fixup section • DCL Dictionary, DCL1-23 
analyzing patch text records • DCL Dictionary, 
DCL1-24 

anayzing global symbol table • DCL Dictionary, 
DCL1-23 

error analysis of • DCL Dictionary, DCL1-22 
invoking • DCL Dictionary, DCL2-11 
Image hibernation 

and RUN command • DCL Dictionary, DCL2-55 
Image size 

specifying with RUN command • DCL Dictionary, 
DCL2-57 
Image wakeup 

and RUN command • DCL Dictionary, DCL2-55 
INCLUDE command • Using VMS, 8-69; EDT Ref, 
EDT-147 

EDT editor* Text Processing, 2-36, 2-51 
INCLUDE FILE command • Using VMS, 8-11, 8-34; 
EVE Ref, EVE-75 

EVE editor* Text Processing, 1-12, 1-47 
reading file into buffer with (EVE) • Text 
Processing, 1-54 

/INCLUDE qualifier • Sort/Merge, SORT-64 
Increment specifier 

with EXIT/SEQUENCE • EDT Ref, EDT-138 
with RESEQUENCE/SEQUENCE • EDT Ref, 
EDT-167 

with /SEQUENCE qualifier • EDT Ref, EDT-170 
with WRITE/SEQUENCE • EDT Ref, EDT-253 
Indentation • EDT Ref, EDT-103, EDT-230, EDT-249 
decreasing level • EDT Ref, EDT-320 
decreasing tab level • EDT Ref, EDT-34 
increasing level • EDT Ref, EDT-323 
increasing tab position • EDT Ref, EDT-30 
increment tab level • EDT Ref, EDT-35 
moving text to right* EDT Ref, EDT-315 
repeat count • EDT Ref, EDT-45 
setting level • EDT Ref, EDT-318 
.INDENT command • Text Processing, 3-19; DSR 
Ref, 2-69 

/INDENT qualifier • DSR Ref, 5-4 
Index 

creating • DCL Dictionary, DCL2-77; DSR Ref, 
2-70 
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creating source file with DSR • DCL Dictionary, 
DCL2-63 

creating with DSR • Text Processing, 3-47, 3-52 
designating entries • DSR Ref, 2-49, 3-12 
entries • DSR Ref, 2-35 
formatting • DSR Ref, 6-6, A-4 
output file • DSR Ref, 6-1 
producing • Using VMS, 9-18; DSR Ref, 6-4 
subentries • DSR Ref, 2-54, 3-17 
.INDEX command • DSR Ref, 2-70, 4-8 
example • DSR Ref, 2-70 
Indexed file • Using VMS, 2-4 

and Sort/Merge Utility • Using VMS, 1-41 
Indexed sort* Using VMS, 1-39 
/IN DEXED_SEQU ENTIAL qualifier • Sort/Merge, 
SORT-45 

Index file • Files and Devices, 1-6, 3-9 
bit map • Files and Devices, A-2 
description of • Files and Devices, 1-5 
INDEXF.SYS • Files and Devices, A-1 
placing on disk* DCL Dictionary, DCL1-245 
Index flag • DSR Ref, 3-12 
default • DSR Ref, 3-12 
subindex flag • DSR Ref, 3-17 
Indexing 

case in entries • DSR Ref, 2-130 
changing heading • DSR Ref, 6-9 
DSR Indexing Utility • DSR Ref, 6-1 
emphasizing entries • DSR Ref, 6-3 
enabling operation of* DSR Ref, 2-31 
entering commands • DSR Ref, 6-4 
example • DSR Ref, 2-70, 6-4 
input files • DSR Ref, 6-6 
merging entries • DSR Ref, 6-2 
merging page number references • DSR Ref, 6-3 
processing a BRN file • DSR Ref, 6-6 
processing an RNO file • DSR Ref, 6-4 
producing a MEX file • DSR Ref, 6-4 
producing an RNX file • DSR Ref, 6-4, 6-9 
punctuation • DSR Ref, 6-1 
qualifiers • DSR Ref, 6-7 
sorting entries • DSR Ref, 6-3 
Indexing Utility 

See also DSR Indexing Utility 
case control • DSR Ref, 6-2 
features • DSR Ref, 6-1 
/INDEX qualifier • DSR Ref, 6-4 
Index sort 

reasons for selecting • Sort/Merge, SORT-29 
specifying • Sort/Merge, SORT-70 
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Initialization 

tape 

using REPLY/BLANKJAPE • DCL Dictionary, 
DCL2-40 

using REPLY/INITIALIZE_TAPE • DCL 
Dictionary, DCL2-40 
volumes • DCL Dictionary, DCL1-240 
Initialization file • Mail, MAIL-16 
at startup • EVE Ref, 1-11, 1-32 
defining keys in EVE • Using VMS, 8-39 
editing-environment commands in • Using VMS, 
8-44 

EVE • DCL Dictionary, DCL1-194 
EVE$INIT.EVE file • EVE Ref, 1-24, 1-32 
EVE$INIT logical name • EVE Ref, 1-24, 1-32 
EVE editor* Text Processing, 1-71, 1-78 
for default settings • EVE Ref, 1-31, EVE-3 
invoking EVE with • Using VMS, 8-44 
saving attributes in (EVE) • Text Processing, 1-61, 
1-71, 1-74, 1-75 

with @ command • EVE Ref, EVE-2 
/INITIALIZATION qualifier • EVE Ref, 1-11, 1-33 
INITIALIZE command • Files and Devices, 3-3; DCL 
Concepts, 8-7; DCL Dictionary, DCL1-240 to 
DCL1-248 
See also Volume 

continuation volumes • Files and Devices, 3-17 
Files-11 On-Disk Structure • Files and Devices, 

3- 4 

magnetic tape • Files and Devices, 5-2 
protection codes • Files and Devices, 4-11 
using to set protection • Files and Devices, 2-6 
INITIALIZE/QUEUE command • DCL Concepts, 8-7; 

DCL Dictionary, DCL1-249 to DCL1-261 
Initializing 

disk volume • Files and Devices, 3-4 
magnetic tape volume • Files and Devices, 3-5, 

4- 7 

volume • Files and Devices, 3-3 
Initial specifier 

with EXIT/SEQUENCE • EDT Ref, EDT-138 
with RESEQUENCE/SEQUENCE • EDT Ref, 
EDT-167 

with /SEQUENCE qualifier • EDT Ref, EDT-170 
with WRITE/SEQUENCE • EDT Ref, EDT-253 
Input 

data lines • Command Procedures, 1-2, 3-5 
entering from a terminal • Command Procedures, 
3—6 

obtaining with INQUIRE command • Command 
Procedures, 3-4 


Input (Cont.) 

obtaining with READ command • Command 
Procedures, 3-4 

opening a file to accept • Command Procedures, 
6-2 

passing as a parameter to a command procedure • 
Command Procedures, 3-1 
to an executable image • Command Procedures, 
3-5 

to batch jobs • Command Procedures, 8-4 
Input data stream 

marking beginning of* DCL Dictionary, DCL1-111 
marking end of • DCL Dictionary, DCL1-206 
Input file 

EVE*DCL Dictionary, DCL1-189, DCL1-192 
qualifier • Sort/Merge, SORT-37 
record size • Sort/Merge, SORT-37 
temporary defaults in a parameter list • DCL 
Concepts, 3-16 

VAXTPU* DCL Dictionary, DCL1-189, DCL1-192 
Input file specification • EVE Ref, 1-2 
Input stream 

defining for created process • DCL Dictionary, 
DCL2-53 

definition • Using VMS, 4-6; DCL Concepts, 4-5 
switching control to other processes • DCL 
Dictionary, DCL1-49 

INQUIRE command • VMS Intro, 5-5; Using VMS, 

5-5, 6-9; DCL Concepts, 5-1, 5-4; DCL 
Dictionary, DCL1-262 to DCL1-264 
converting input data with • Command Procedures, 
3-4 

evaluating input from using the IF command • 
Command Procedures, 5-8 
in a batch job command procedure • Command 
Procedures, 3-4 

obtaining input • Command Procedures, 3-4 
using to obtain a value for a variable • Command 
Procedures, 5-2 

INSERT command • EDT Ref, EDT-148 
EDT editor • Text Processing, 2-24 
Insert Here buffer 

EVE contents of • Text Processing, 1-20 
INSERT HERE command • Using VMS, 8-15; EVE 
Ref, EVE-76 

moving text with (EVE) • Text Processing, 1-18 
Insert Here key 

moving text with (EVE) • Text Processing, 1-18 
INSERT HERE key 
See also PASTE 

on LK201 keyboard • EDT Ref, EDT-84 
Inserting comments • DSR Ref, 2-46 
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Inserting text • DSR Ref, 3-9 
blank lines • DSR Ref 2-115 
date • DSR Ref 2-109, 3-18 
EVE editor* Text Processing, 1-20 
footnotes • DSR Ref A-3 
line mode • EDT Ref EDT-148 
nokeypad mode • EDT Ref EDT-292 
notes • DSR Ref A-3 
repeating characters • DSR Ref 2-102 
time • DSR Ref 2-109, 3-18 
Insert line 

with INSERT • EDT Ref EDT-148 
with REPLACE • EDT Ref EDT-165 
Insert mode 

definition • DCL Concepts, 2-4 
editing command line in • Using VMS, 1-23 
EVE editor* Text Processing, 1-12 
using EVE in • Using VMS, 8-11 
INSERT MODE command • EVE Ref EVE-77 
EVE editor* Text Processing, 1-12 
INSERT PAGE BREAK command • Using VMS, 8-36; 
EVE Ref EVE-78 

formatting text with (EVE) • Text Processing, 1-40 
with WPS keypad • EVE Ref EVE-186 
/INSERT qualifier* VMS Intro, 6-15 
Installation routine • Files and Devices, 2-4 
INSTALL command • DCL Dictionary, DCL1-265 
Installed files 

displaying names of • DCL Dictionary, DCL2-265 
Integer 

See Number 
Integer variable 

in VAXTPU procedure • Text Processing, 1-69 
Interactive 

assignment of symbols • DCL Dictionary, 
DCL1-262 

help* DCL Dictionary, DCL1-233 
Interactive command 

definition • DCL Concepts, 1-1 
Interactive execution of command procedure • 
Command Procedures, 1-5 
Interactive mode 

definition • Using VMS, 1-6; DCL Concepts, 1-1 
Interchange environment 

protection • Files and Devices, 2-7 
/INTERFACE qualifier • EVE Ref 1-12 
Intermediate file 

with DSR • Text Processing, 3-48, 3-53 
/INTERMEDIATE qualifier • DSR Ref 4-14, 5-2, 6-4 
Interrupting a DCL command • DCL Concepts, 2-1 
to 2-3 


Interruption • EDT Ref EDT-7 

recovering from • EDT Ref EDT-169 
Invoking • EVE Ref 1-5 
ISO standard ♦ Files and Devices, B-1 

structure of magnetic tape • Files and Devices, 

1—6 

Iterative substitution 

definition • DCL Concepts, 7-5 
during the three phases of command processing • 
DCL Concepts, 7-4 
in an expression • DCL Concepts, 7-6 
using apostrophes • DCL Concepts, 7-5 
using command synonyms • DCL Concepts, 7-6 
Iterative translation 

See also Logical name translation 
and SHOW LOGICAL command • Using VMS, 4-4 
and SHOW TRANSLATION command • Using 
VMS, 4-4 

definition • Using VMS, 4-4, 4-12; DCL 
Concepts, 4-3, 4-12 
preventing • Using VMS, 4-13 


J 


Job 

defining default CPU time limit • DCL Dictionary, 
DCL1-253, DCL2-204, DCL2-347 
defining maximum CPU time limit • DCL Dictionary, 
DCL1-253, DCL2-205, DCL2-348 
deleting from queue • DCL Dictionary, DCL1-136, 
DCL1-143 

redirecting to another queue • DCL Dictionary, 
DCL1-46 

removing from queue 

with ASSIGN/MERGE command • DCL 
Dictionary, DCL1-46 
Job batch card 

end of • DCL Dictionary, DCL1-208 
JOB card 

password • DCL Dictionary, DCL2-9 
JOB command* DCL Dictionary, DCL1-266 to 
DCL1-271 
Job logical name 

definition • Using VMS, 4-6; DCL Concepts, 4-6 
function in a job tree • Using VMS, 4-6; DCL 
Concepts, 4-6 
Job logical name table 

canceling entries* DCL Dictionary, DCL1-105 
default contents • DCL Concepts, 4-6 
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Job logical name table (Cont.) 

including logical name • DCL Dictionary, DCL1-41, 
DCL1-116 

limiting its size • DCL Concepts, 4-17 
list of default contents of • Using VMS, 4-6 
logical name for • Using VMS, 4-6; DCL 
Concepts, 4-6 
Job tree • Using VMS, 3-5 

definition • Using VMS, 4-5; DCL Concepts, 4-5 
JOU file type • EDT Ref, EDT-7 
Journal 

EVE • DCL Dictionary, DCL1-195, DCL1-198 
VAXTPU • DCL Dictionary, DCL1-195, DCL1-198 
Journal file • EDT Ref, EDT-7, EDT-169; EVE Ref, 
1-12, 1-15 

deleting • EVE Ref, 1-23 
directory for • EVE Ref, 1-21 
EDT • Using VMS, 8-54; Text Processing, 2-6, 
2-36 

EVE • Using VMS, 8-23 
EVE editor* Text Processing, 1-37 
naming • EVE Ref, 1-21 
saving • EDT Ref, EDT-138 
with /SAVE qualifier • EDT Ref, EDT-140, 
EDT-161 

Journaling • EVE Ref, 1-12 
EVE 

buffer-change • Text Processing, 1-37; EVE 
Ref, 1-2, 1-12,1-15 

keystroke • Text Processing, 1-37; EVE Ref, 
1-12, 1-15 

Journaling facility • EDT Ref, EDT-7 
/JOURNAL qualifier* EVE Ref, 1-12 
.JUSTIFY command 

example • DSR Ref, 2-71 
Justifying text 

See also Text formatting 
example • DSR Ref, 2-71 
using DSR • Text Processing, 3-14 


K 


.KEEP command • DSR Ref, 2-73 
example • DSR Ref, 2-73 
/KEEP qualifier* VMS Intro, 5-11 
Kernel mode 

See also Access mode 
Key 

See also Key definition 
equal • Sort/Merge, SORT-2 


Key (Cont.) 

function • Using VMS, 1-17 to 1-19 
multiple • Sort/Merge, SORT-2 
sort* Using VMS, 1-38 
specifying • Sort/Merge, SORT-1, SORT-2, 
SORT-66 

data type • Sort/Merge, SORT-26 
order • Sort/Merge, SORT-26 
position • Sort/Merge, SORT-26 
size • Sort/Merge, SORT-26 
Keyboard keys* VMS Intro, 1-1 
Key definition • EDT Ref, EDT-131 
assigning • Using VMS, 1-24, 1-25 
in EDT* Using VMS, 8-71 
in EVE • Using VMS, 8-39 
definable keys • Using VMS, 1-24; DCL 
Concepts, 2-9 
deleting • Using VMS, 1-26 
description • DCL Concepts, 2-9 
displaying • Using VMS, 1-26; Mail, MAIL-102; 

EDT Ref, EDT-38 
EDT • Text Processing, 2-44, 2-48 
EVE editor* Text Processing, 1-60 
in an initialization file (EVE) • Text Processing, 

1-61 

preset • EDT Ref, EDT-215 
Key names • EVE Ref, 1-25 
Key name specifier 

with DEFINE KEY • EDT Ref, EDT-130 
Keypad 

ACL Editor diagram • Using VMS, 7-15 
application 

setting for DECterm • DCL Dictionary, 
DCL1-98 

default definitions • Mail, MAIL-15 

default editing keys for EDT • Text Processing, 2-5 

default editing keys for EVE • Text Processing, 1-4 

displaying EDT keypad in EVE • Using VMS, 8-23 

displaying EVE keypad • Using VMS, 8-23 

displaying WPS keypad in EVE • Using VMS, 8-23 

EDT option • Using VMS, 8-49 

EDT option (EVE) • Text Processing, 1-6 

EVE 

on VT100-series terminal • Using VMS, 8-6 
on VT200- and VT300-series terminals • Using 
VMS, 8-6 
getting help for 

EVE editor* Text Processing, 1-36 
MAIL diagram • Using VMS, 1-35 
WPS option (EVE) • Text Processing, 1-6 
Keypad commands 

list of by function • EDT Ref, EDT-15 
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Keypad diagram • EVE Ref, EVE-72 
Keypad key numbers 

figure of • EDT Ref, EDT-10 
Keypad keys 

See also SHOW KEY command 
defining • EDT Ref, EDT-8, EDT-9 
figure of VT100-series terminals • EDT Ref, EDT-3 
figure of VT52-series terminals • EDT Ref, EDT-3 
redefining • EDT Ref, EDT-9 
Keypad mode • EDT Ref, EDT-2, EDT-4 
See also SHOW KEYPAD command 
changing to line mode • EDT Ref, EDT-1 
deleting text with EDT • Text Processing, 2-14 
editing file • EDT Ref, EDT-1 
EDT • Text Processing, 2-2, 2-7 
finding text with EDT • Text Processing, 2-16 
HELP key • EDT Ref, EDT-2 
inserting text with EDT • Text Processing, 2-10 
moving text with EDT • Text Processing, 2-18 
moving the cursor with EDT • Text Processing, 
2-10 

replacing text with EDT • Text Processing, 2-20 
restoring text with EDT • Text Processing, 2-14 
Keypad mode definitions 

on LK201 keyboard • EDT Ref, EDT-3 
/KEY qualifier* Sort/Merge, SORT-26, SORT-66 
Keys 

Alt combinations • EVE Ref, 1-25 
DECwindows-style • EVE Ref, 1-27, EVE-164 
shifted function • EVE Ref, 1-25 
Keys defined 

list of • EVE Ref, EVE-72 
Key state • Using VMS, 1-25 
changing • Using VMS, 1-25 
Keystroke journaling • EVE Ref, 1-12, 1-20, 1-23 
EVE editor* Text Processing, 1-36 
restrictions • EVE Ref, 1-24 
with software performance report* EVE Ref, 1-24 
Keyword • VMS Intro, 1-4 

abbreviating • DCL Concepts, 1-12 
definition • Using VMS, 1-9; DCL Concepts, 1-3; 
DSR Ref, 1-2 

KS (KED substitute) command • EDT Ref, EDT-294 
See also Cursor positioning 


L 


Label 

ANSI • Files and Devices, B-1, B-3 
command interpreter rules for • DCL Dictionary, 
DCL1-52, DCL1-227, DCL1-229 
DCL syntax line* DCL Concepts, 1-3 
definition • Using VMS, 1-9 
EOF (end-of-file) • Files and Devices, B-16 
EOV (end-of-volume) • Files and Devices, B-16 
HDR1 • Files and Devices, B-10 
HDR2 • Files and Devices, B-13 
HDR3 • Files and Devices, B-16 
HDR4 • Files and Devices, B-16 
header • Files and Devices, B-9 
in command procedure • Command Procedures, 
1-4; DCL Dictionary, DCL1-52, DCL1-227, 
DCL1-229 

syntax* DCL Dictionary, DCL1-227, 
DCL1-229 

in DCL command line • Using VMS, 1-8 
ISO • Files and Devices, B-1 
specifying for volume • DCL Dictionary, DCL2-241 
trailer • Files and Devices, 1-7, B-16 
VOL1 • Files and Devices, B-8 
volume header • DCL Dictionary, DCL1-240 
with the GOSUB command • Command 
Procedures, 5-10 

with the GOTO command • Command Procedures, 
5-9 

writing on volume* DCL Dictionary, DCL1-240 
LANDSCAPE option • DSR Ref, 4-9 
Language compilers 

effects of qualifiers on output files • DCL Concepts, 
1-10 to 1-11 
Laser printers 

LN01 • DSR Ref, B-1 
LN01E • DSR Ref, B-1 
LN03 • DSR Ref, B-1 
LAST command 
See Reading 

.LAYOUT command • DSR Ref, 2-75 
example • DSR Ref, 2-75 
.LE. 

in a numeric comparison • DCL Concepts, 6-7 
LEARN command • EVE Ref, EVE-79 to EVE-80 
EVE editor* Text Processing, 1-61 
Learn sequence 

assigning to a key (EVE) • Text Processing, 1-61 
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Learn sequence (Cont.) 

canceling (EVE) • Text Processing, 1-61 
defining • Using VMS, 8-40 
definition (EVE) • Text Processing, 1-59 
saving (EVE) • Text Processing, 1-61 
LEFT arrow key • DCL Concepts, 2-5; EOT Ref, 
EDT-77, EDT-295 
See also Cursor movement 
moving cursor with • Using VMS, 1-18 
moving the cursor with • Text Processing, 1-8 
.LEFT MARGIN command • Text Processing, 3-12; 

DSR Ref, 2-78 
.LES. 

in a string comparison • DCL Concepts, 6-2 
Less than operator 

symbol for in expressions • Command Procedures, 
2-13 

Less than or equal to operator 

symbol for in expressions • Command Procedures, 
2-13 

Letter 

chapter number (DSR) • Text Processing, 3-33 
page number (DSR) • Text Processing, 3-34 
Lettered list 
See List 

Lexical functions • VMS Intro, 5-8; Command 
Procedures, B-1 to B-3; DCL Dictionary, 
DCL1-273, DCL1-274 

and logical name translation • Using VMS, 4-4 
definition • Using VMS, 5-9; DCL Concepts, 5-6; 

Command Procedures, 2-11, 4-1 
evaluating • Using VMS, 5-10; Command 
Procedures, 2-11 

F$CONTEXT • DCL Dictionary, DCL1-275 
F$CSID • DCL Dictionary, DCL1-280 
F$CVSI • DCL Dictionary, DCL1-282 
F$CVTIME • DCL Dictionary, DCL1-284 
F$CVUI • DCL Dictionary, DCL1-286 
F$DEVICE • DCL Dictionary, DCL1-287 
F$DIRECTORY • DCL Dictionary, DCL1-289 
F$EDIT • DCL Dictionary, DCL1-290 
F$ELEMENT • DCL Dictionary, DCL1-292 
F$ENVIRONMENT • DCL Dictionary, DCL1-294 
F$EXTRACT • DCL Dictionary, DCL1-297 
F$FAO • DCL Dictionary, DCL1-299 
F$FILE_ATTRIBUTES • DCL Dictionary, 
DCL1-306 

F$GETDVI • DCL Dictionary, DCL1-309 
FSGETJPI • DCL Dictionary, DCL1-322 
F$GETQUI • DCL Dictionary, DCL1-328 
F$GETSYI • DCL Dictionary, DCL1-344 
F$IDENTIFIER • DCL Dictionary, DCL1-349 


Lexical functions (Cont.) 

F$INTEGER • DCL Dictionary, DCL1-351 
F$LENGTH • VMS Intro, 5-8; DCL Dictionary, 
DCL1-352 

F$LOCATE • DCL Dictionary, DCL1-353 
F$MESSAGE • DCL Dictionary, DCL1-355 
F$MODE • DCL Dictionary, DCL1-356 
F$PARSE • DCL Dictionary, DCL1-358 
F$PID • DCL Dictionary, DCL1-361 
F$PRIVILEGE • DCL Dictionary, DCL1-363 
F$PROCESS • DCL Dictionary, DCL1-364 
F$SEARCH • DCL Dictionary, DCL1-365 
F$SETPRV • DCL Dictionary, DCL1-368 
F$STRING • DCL Dictionary, DCL1-372 
F$TIME • DCL Dictionary, DCL1-373 
F$TRNLNM • DCL Dictionary, DCL1-374 
F$TYPE • DCL Dictionary, DCL1-378 
F$USER • DCL Dictionary, DCL1-380 
FSVERIFY* DCL Dictionary, DCL1-381 
invoking • Using VMS, 5-9 
list of functions used to save and restore process 
characteristics • Using VMS, 6-34 
overview • DCL Dictionary, DCL1-272 
specifying arguments for • Command Procedures, 
2-11 

summary of • Command Procedures, B-1 
symbol substitution in • Using VMS, 5-6 
syntax • Using VMS, 5-9; DCL Concepts, 5-6 
using in command procedure • Using VMS, 5-9, 
6-12 

with WRITE command • Command Procedures, 
6-5 

Lexical input phase 

See Command input scanning 
Library 

object module • DCL Dictionary, DCL1-28 
LIBRARY command • DCL Dictionary, DCL1-383 
LICENSE command • DCL Dictionary, DCL1-384 
License Management Utility (LICENSE) • DCL 
Dictionary, DCL2-285 
Licenses 

displaying active • DCL Dictionary, DCL2-285 
Limit working set 

displaying • DCL Dictionary, DCL2-335 
Line breaks • DSR Ref, 2-10 
LINE command • Using VMS, 8-9, 8-56; EDT Ref, 
EDT-78; EVE Ref, EVE-81 
See also Cursor movement 
moving the cursor with (EVE) • Text Processing, 
1-9 

Line commands 

list of by function • EDT Ref, EDT-115 
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Line editing 

See also Command line 
See also Editing the command line 
LINEFEED • EDT Ref, EDT-79 
See also Deleting text 

LINEFEED key • Using VMS, 1-18; DCL Concepts, 
2-6 

EDT • Text Processing, 2-14 
LINE keypad function 

EDT • Text Processing, 2-11 
Line mode • EDT Ref, EDT-5 

changing to keypad mode • EDT Ref, EDT-1 
changing to nokeypad mode • EDT Ref, EDT-1 
command 

with EXT (extend) • EDT Ref, EDT-288 
copying text with EDT • Text Processing, 2-30 
deleting text with EDT • Text Processing, 2-27 
editing file • EDT Ref, EDT-1 
EDT • Text Processing, 2-2, 2-22 
HELP • EDT Ref, EDT-2 
inserting text with EDT • Text Processing, 2-24 
line numbers (EDT) ♦ Text Processing, 2-22 
moving text with EDT • Text Processing, 2-29 
qualifiers • EDT Ref, EDT-6 
replacing text with EDT • Text Processing, 2-28, 

2-30 

specifiers • EDT Ref, EDT-6 
specifying a range with EDT • Text Processing, 

2-25 
Line numbers 

with LINE command • EVE Ref, EVE-81 
Line spacing • DSR Ref, 2-115, 2-116 
/LINES_PER_PAGE=n qualifier • DSR Ref, 6-7 
Line terminator • Using VMS, 1-19; DCL Concepts, 
2-1 

LINK command • VMS Intro, 4-2, 4-8, 4-13; 

Using VMS, 4-13; DCL Concepts, 4-13; DCL 
Dictionary, DCL1-385 to DCL1-391 
Linker • VMS Intro, 4-2 

memory allocation file • DCL Dictionary, 
DCL1-386, DCL1-387 
Linker (LINK) 

directing output* DCL Dictionary, DCL1-385 
invoking* DCL Dictionary, DCL1-385 
Link option specification records 

analyzing in object file • DCL Dictionary, DCL1-28 
List 

bulleted (DSR) • Text Processing, 3-7 

creating • DSR Ref, 2-79 

elements in • DSR Ref, 2-82 

formatting • Using VMS, 9-8; DSR Ref, A-3 


List (Cont.) 

formatting with DSR • Text Processing, 3-6 
lettered (DSR) • Text Processing, 3-10 
lettering in • DSR Ref, 2-20 
numbering in • DSR Ref, 2-20 
numbering of • DSR Ref, 2-90 
.LIST command • Text Processing, 3-6, 3-12; DSR 
Ref, 2-79 

example • DSR Ref, 2-82 
.LIST ELEMENT command • Text Processing, 3-6, 

3-12; DSR Ref, 2-82 
List files 

in directory • DCL Dictionary, DCL1-159 
.LITERAL command • Text Processing, 3-12, 3-22, 

3- 25,3-26; DSR Ref, 2-83 
LK201 keyboard 

arrow keys • EDT Ref, EDT-3 
DELETE key • EDT Ref, EDT-56 
DO key • EDT Ref, EDT-61 
FI 3 key • EDT Ref, EDT-79 
figure of • EDT Ref, EDT-4 
Find key • EDT Ref, EDT-69 
function keys* EDT Ref, EDT-3, EDT-130 
HELP key • EDT Ref, EDT-76 
INSERT HERE key • EDT Ref, EDT-84 
LN01E laser printer 
See Printers 
LN01 laser printer 
See Printers 
LN03 laser printer 
See Printers 
LNI file • DSR Ref, B-1 

font definitions • DSR Ref, B-3 
LNM$DCL_LOGICAL • DCL Concepts, 4-10 
LNM$DIRECTORIES • DCL Concepts, 4-10 
LNM$FILE_DEV • DCL Concepts, 4-10 

to redefine the search order* DCL Concepts, 4-16 
LNM$GROUP • Using VMS, 4-7; DCL Concepts, 

4- 6, 4-9, 4-10 

LNM$JOB • Using VMS, 4-6; DCL Concepts, 4-6, 

4—9, 4—10 

LNM$PERMANENT_MAILBOX • DCL Concepts, 

4—10 

LNM$PROCESS • Using VMS, 4-5; DCL Concepts, 
4-5, 4-9 

LNM$PROCESS_DIRECTORY • Using VMS, 4-9; 

DCL Concepts, 4-8, 4-9 
LNM$PROCESS_TABLE • DCL Concepts, 4-9 
LNM$SYSTEM • Using VMS, 4-7; DCL Concepts, 
4-7, 4-11 

LNM$SYSTEM_DIRECTORY • Using VMS, 4-9; 

DCL Concepts, 4-8, 4-11 


Index-48 





Index 


LNM$SYSTEM_TABLE • DCL Concepts, 4-11 
LNM$TEMPORARY_MAILBOX • DCL Concepts, 

4-11 

Local node 

copying files from remote node to • Using VMS, 
2-14 

definition* Using VMS, 1-3 
displaying remote files from • Using VMS, 2-11 
Local symbol • Using VMS, 5-2; DCL Dictionary, 
DCL1-1, DCL1-5 
Local symbol table 

definition • Using VMS, 5-3; DCL Concepts, 5-1 
deleting symbols from • DCL Dictionary, 

DCL1-145 

entering symbol in • DCL Dictionary, DCL1-263 
in the search order • DCL Concepts, 5-3 
PI through P8 • Using VMS, 5-3; DCL Concepts, 
5-1 

search order • Using VMS, 5-5 
Locating text 
buffer specifier 

line mode • EDT Ref, EDT-120 
CLSS (clear search string) • EDT Ref, EDT-270 
FIND • EDT Ref, EDT-61, EDT-69, EDT-143 
FNDNXT • EDT Ref, EDT-71 
KS (KED substitute) • EDT Ref, EDT-294 
SET SEARCH • EDT Ref, EDT-69, EDT-192 
SHOW SEARCH • EDT Ref, EDT-227 
SSEL (search and select) • EDT Ref, EDT-312 
string specifier 

line mode • EDT Ref, EDT-241 
nokeypad mode • EDT Ref, EDT-313 
Lock limit 

specifying for detached process • DCL Dictionary, 
DCL2-57 

specifying for subprocess • DCL Dictionary, 
DCL2-57 

Log file 

contents of • Command Procedures, 8-5 
examining during execution of batch job • 
Command Procedures, 8-5 
for batch job • Using VMS, 3-9 
status when batch job is stopped abnormally • 
Command Procedures, 8-8 
Logging in • DCL Dictionary, DCL1-392 to 
DCL1-395 

Logging out • DCL Dictionary, DCL1-396 

and device access • DCL Dictionary, DCL1-15 
Logical name • VMS Intro, 3-8, 4-14; Mail, MAIL-15 
See also Job logical name 
See also Logical name table 
See also Process logical name 


Logical name (Cont.) 

access modes • Using VMS, 4-13; DCL 
Concepts, 4-14; Command Procedures, 

2-4 

as device name • Using VMS, 2-10 
assigning • Command Procedures, 2-2; DCL 
Dictionary, DCL1-39, DCL1-114 
assigning to device* DCL Dictionary, DCL1-15 
attributes of • Command Procedures, 2-4 
canceling • DCL Dictionary, DCL1-104 
concealed device name • Using VMS, 4-13; DCL 
Concepts, 4-13 

creating • DCL Concepts, 4—2; Command 

Procedures, 2-2; DCL Dictionary, DCL1-39, 
DCL1-114 

creating a table • DCL Dictionary, DCL1-93 
deassigning using CLOSE command • DCL 
Dictionary, DCL1-58 

defined as a search list 'Using VMS, 4-15; DCL 
Concepts, 4-18 
defining • Using VMS, 4-2 
definition • Command Procedures, 2-1 
deleting • Command Procedures, 2-2 
differences from symbols • Command Procedures, 

2- 15 

displaying • Using VMS, 4-4; Command 
Procedures, 2-4 

equivalence name for • DCL Dictionary, 
DCL2-288, DCL2-329 
translation of • DCL Dictionary, DCL2-288, 
DCL2-329 

equivalence name • Using VMS, 4-1 
EVE$INIT • DCL Dictionary, DCL1 -194; EVE Ref, 
1-11, 1-24 

for a mounted disk or tape • Using VMS, 4-6; 

DCL Concepts, 4-6 
for a network • Using VMS, 4-16 
for a node specification • Using VMS, 4-16; DCL 
Concepts, 4-21 to 4-23 
for a temporary mailbox • DCL Concepts, 4-6 
in a file specification • Command Procedures, 2-2 
in an input file list* DCL Concepts, 4-13 
in the device field of a file specification • DCL 
Concepts, 3-6 
MAIL$EDIT • EVE Ref, 1-24 
overview • Using VMS, 4-1; DCL Concepts, 4-1 
placing in a user-defined table • DCL Concepts, 
4-16 

preventing definition in subprocesses • Using VMS, 

3— 8 

process-permanent • Using VMS, 4-17 

defining equivalence name for detached 
process • DCL Dictionary, DCL2-53 
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Logical name 

process-permanent (Cont.) 

defining equivalence name for subprocess• 
DCL Dictionary, DCL2-53 
rules for creating • Using VMS, 4-2; DCL 
Concepts, 4-2 

search list • Using VMS, 4-15; Command 
Procedures, 2-4 

system-created • Using VMS, 4-17 
system default* VMS Intro, 3-10 
system-permanent • Using VMS, 4-20 
to obtain output value • Command Procedures, 

3- 12 

to refer to a device • Command Procedures, 2-2 
TPU$COMMAND • DCL Dictionary, DCL1-191; 
EVE Ref, 1-8 

TPU$DEBUG • DCL Dictionary, DCL1-193; EVE 
Ref, 1-10 

TPU$DISPLAY_MANAGER • DCL Dictionary, 
DCL1-193; EVE Ref, 1-10 
TPU$JOURNAL • DCL Dictionary, DCL1-196 
TPU$SECTION • DCL Dictionary, DCL1-200; 

EVE Ref, 1-16, 1-24 

TPU$WORK* DCL Dictionary, DCL1-202; EVE 
Ref, 1-19 

translation in file specifications • Using VMS, 4-2; 
DCL Concepts, 1-6 

translation of • Command Procedures, 2-1 
use in programming • VMS Intro, 4-14 
use of the colon • DCL Concepts, 4-2 
use with certain commands • Phone, PHONE-8 
with the OPEN command • Command Procedures, 
6-1 

Logical name directory table 

definition • Using VMS, 4-9; DCL Concepts, 4-1, 

4— 8 

process • Using VMS, 4-9; DCL Concepts, 4-8 
system • Using VMS, 4-10; DCL Concepts, 4-9 
Logical name inclusion 

in group logical name table • DCL Dictionary, 
DCL1-41, DCL1-116 

in job logical name table • DCL Dictionary, 
DCL1-41, DCL1-116 

in process logical name table • DCL Dictionary, 
DCL1-41, DCL1-116 

in system logical name table • DCL Dictionary, 
DCL1-41, DCL1-116 
Logical names 

TPU$JOURNAL 'EVE Ref, 1-21 
Logical name table • Files and Devices, 3-7 
See also Group logical name table 
See also Job logical name table 


Logical name table (Cont.) 

See also Process logical name table 
See also System logical name table 
ACL-based protection • DCL Concepts, 4-18 
creating • Using VMS, 4-14; Command 

Procedures, 2-3; DCL Dictionary, DCL1-93 
defining access mode • Using VMS, 4-13; DCL 
Concepts, 4-17 

definition • Using VMS, 4-5; DCL Concepts, 4-1, 
4-4; Command Procedures, 2-3 
deleting • Using VMS, 4-14; DCL Dictionary, 
DCL1-104 

displaying • DCL Dictionary, DCL2-288 
group • Command Procedures, 2-3 
including a user-defined table in the search order • 
DCL Concepts, 4-16 
job • Command Procedures, 2-3 
limiting its size • DCL Concepts, 4-16 
list of system-provided • Using VMS, 4-1; DCL 
Concepts, 4-1 

process • Command Procedures, 2-3 
process-private • Using VMS, 4-5; DCL 
Concepts, 4-15 

rules for creating • DCL Concepts, 4-15 
search order • Using VMS, 4-5, 4-12; DCL 
Concepts, 4-11 

shareable • Using VMS, 4-6; DCL Concepts, 4-6, 
4-15 

definition • Using VMS, 4-5 
system • Command Procedures, 2-3 
UlC-based protection • DCL Concepts, 4-18 
Logical name table protection 

access types • DCL Concepts, 8-10 
how to set • DCL Concepts, 8-10 
Logical name translation 

and wildcards • Using VMS, 4-15 
default search order • Using VMS, 4-11; DCL 
Concepts, 4-11 

default values • Using VMS, 4-13; DCL Concepts, 
4—13 

in file specifications* Using VMS, 4-13; DCL 
Concepts, 4-13 to 4-14 

iterative • Using VMS, 4-12; DCL Concepts, 4-12 
preventing iterative translation • Using VMS, 4-13; 
DCL Concepts, 4-13 

when the file specification contains a wildcard • 
DCL Concepts, 4-19 
Logical operators • Using VMS, 5-12 
Logical queue • DCL Dictionary, DCL1-252 
deassigning • DCL Dictionary, DCL1-109 
Login • VMS Intro, 1-1 

automatic* Using VMS, 1-3 
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Login (Cont.) 

dial-in • Using VMS, 1-4 
failure • VMS Intro, 1-2 
manual • Using VMS, 1-1 
network* Using VMS, 1-3 
procedure • VMS Intro, 1-2 
LOGIN.COM file 

See Login command file, Login command 
procedure 

Login command file • VMS Intro, 5-9 
Login command procedure • Files and Devices, 2-8; 
Command Procedures, 1-9 
executing • DCL Dictionary, DCL1-392 
execution of for batch jobs • Command 
Procedures, 8-2 

location of 'Command Procedures, 1-11 
personal • Using VMS, 6-4; Command 
Procedures, 1-9 

defining EVE$INIT in • Using VMS, 8-44 
defining keys in • Using VMS, 1-25 
defining logical names in • Using VMS, 4-1 
defining symbols in • Using VMS, 1-24 
definition • Using VMS, 1-3, 6-4 
executed as batch jobs • Using VMS, 3-9 
location of • Using VMS, 6-4 
sample • Using VMS, 6-4 
specifying alternate file specification ♦ Using 
VMS, 6-6 

specifying alternate • DCL Dictionary, DCL1-393 
system • Using VMS, 1-2 
system-defined • Command Procedures, 1-9 
Login directory file • Using VMS, 2-1, 2-6 
LOGINOUT.EXE file 

and detached process • DCL Dictionary, DCL2-56 
Logout* VMS Intro, 1-9 

LOGOUT command* VMS Intro, 1-9; Using VMS, 
1-5, 3-6; DCL Dictionary, DCL1-396 to 
DCL1-397 

message • DCL Dictionary, DCL1-396 
multiple • DCL Dictionary, DCL1-396 
network • Using VMS, 1-4 
/LOG qualifier • DSR Ref, 4-14, 5-4, 6-8 
Longest record length 
See LRL 
Longword 

definition • Using VMS, 5-1 
Longword dump • DCL Dictionary, DCL1-176 
Loop 

in a command procedure • Command Procedures, 
5-14 

LOWERCASE command • Using VMS, 8-30 
EVE editor* Text Processing, 1-46 


Lowercase flag • DSR Ref, 3-13 
default • DSR Ref, 3-13 
pairing • DSR Ref, 3-13 
recognizing • DSR Ref, 2-50 
LOWERCASE WORD command • Using VMS, 8-36; 
EVE Ref, EVE-82 

formatting text with (EVE) • Text Processing, 1-40 
using with search string (EVE) • Text Processing, 
1-20 

Low-order unit 

definition • Using VMS, 5-1 
LRL (longest record length) • Sort/Merge, SORT-37 
.LT. 

in a numeric comparison • DCL Concepts, 6-7 
.LTS. 

in a string comparison • DCL Concepts, 6-2 


M 


Machine code • VMS Intro, 4-2 
Macro 

deleting • EDT Ref, EDT-133 
EDT • Text Processing, 2-49 
saving • EDT Ref, EDT-133 
MACRO command • VMS Intro, 4-12; DCL 
Dictionary, DCL1-398 to DCL1-403 
Macro name specifier 

with DEFINE MACRO • EDT Ref, EDT-133 
Magnetic tape 
accessing 

examples of ♦ Files and Devices, 4-13 
allocation of • Files and Devices, 3-1,4-15 
ANSI-labeled 

mounting • Files and Devices, 3-12 
basic concepts of • Files and Devices, 1-6 
block • Files and Devices, 1-7 
copying files from • Files and Devices, 5-3 
deallocating drives • Files and Devices, 3-20 
density • Files and Devices, 1-7 
device characteristics for • DCL Dictionary, 
DCL2-177 

dismounting • DCL Dictionary, DCL1-170 
DOS-11 • Files and Devices, 5-3, 5-10 
file • Files and Devices, 1-7 

reading • Files and Devices, 4-18 
file protection 

See also Protection 

initializing • Files and Devices, 3-5; DCL 
Dictionary, DCL1-240 
installation routine • Files and Devices, 2-4 
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Magnetic tape (Cont.) 

interrecord gap (IRG) • Files and Devices, 1-7 
label format • Files and Devices, 3-12 
modifying device characteristics • Files and 
Devices, 4-10 

mounting • Files and Devices, 3-11 
See also MOUNT command 
overriding overwrite protection on • DCL 
Dictionary, DCL1-246 
reading from • Files and Devices, 4-19 
record blocking • Files and Devices, 1-7 
record format • Files and Devices, 5-3 
retrieving device information • Files and Devices, 
4-6 

runaway stop • DCL Dictionary, DCL1-241 
specifying block size for • Files and Devices, 3-12 
specifying record size for • Files and Devices, 
3-15 

specifying volume density • DCL Dictionary, 
DCL1-242 

9-track drive • Files and Devices, B-1 
volume • Files and Devices, 5-2 
See also Volume 
volume protection 
See Protection 
volume set 

See Volume set 

writing files to • Files and Devices, 4-15, 4-19 
Magnetic tape ancillary control process 
See MTAACP 
Magnetic tape volume 
See Tape volume 
MAIL 

See Mail Utility 

MAIL$EDIT logical name* EVE Ref, 1-24 
MAIL$INIT file • Mail, MAIL-16 
MAIL$SYSTEM_FLAGS logical name* Mail, MAIL-14 
MAIL.MAI file • Mail, MAIL-1 
Mailbox 

process termination • DCL Dictionary, DCL2-58 
MAIL command • Using VMS, 1-27; Mail, MAIL-57; 
DCL Dictionary, DCL1-404 

See also SEND command 
MAIL folder 

creating • Using VMS, 1-33 
deleting • Using VMS, 1-34 
displaying list of ’Using VMS, 1-33 
MAIL • Using VMS, 1-31, 1-32 
NEWMAIL • Using VMS, 1-30, 1-32 
selecting* Using VMS, 1-33 
WASTEBASKET • Using VMS, 1-32 


Mail subdirectory 

creating • Using VMS, 1-27 
Mail Utility (MAIL) • VMS Intro, 1-10; DCL 
Dictionary, DCL1-404 
commands • Mail, MAIL-24 to MAIL-106 
creating mail files • Using VMS, 1-34 
DCL commands • Mail, MAIL-1 
DCL qualifiers • Mail, MAIL-19 to MAIL-23 
deleting a message in • Using VMS, 1-32 
displaying information about • Mail, MAIL-99 
exiting • Using VMS, 1-27; Mail, MAIL-18 
exiting from • Mail, MAIL-47, MAIL-68 
extracting a message to a file with • Using VMS, 
1-31 

invoking • Using VMS, 1-27; Mail, MAIL-1, 
MAIL-18 
keypad 

commands • Using VMS, 1-34 
diagram • Using VMS, 1-35 
notification of • Mail, MAIL-1 
protecting mail files in • Using VMS, 7-11 
protection • Files and Devices, 2-13 
reading a message in • Using VMS, 1-30 to 1-31 
sending a file from DCL level with • Using VMS, 

1- 29 

sending a file in MAIL with • Using VMS, 1-28, 

2- 16 

sending a message over network with • Using 
VMS, 1-28 

sending a message to a distribution list with • 
Using VMS, 1-29 

setting default editor in • Using VMS, 1-35 
specifying mail files • Mail, MAIL-11 
using EVE within • EVE Ref, 1-24 
using text editor in • Using VMS, 1-28 
wastebasket folder • Mail, MAIL-8 
Mapping pointer allocation • DCL Dictionary, 
DCL1-248 

Margin • DSR Ref, 2-69 

positioning right • DSR Ref, 2-104 
right • DSR Ref, 4-21 
setting • DSR Ref, 2-78, A-2 
setting right • DSR Ref, 2-105 
Margin adjustment 
DSR • Using VMS, 9-5 
Margins 

setting with EVE* Text Processing, 1-40, 1-41 
MARK command ♦ Using VMS, 8-19; Mail, MAIL-59; 
EVE Ref, EVE-83 
EVE editor* Text Processing, 1-32 
using (EVE) • Text Processing, 1-32 
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MARK name 

EVE editor* Text Processing, 1-32 
Mass storage device 

definition • Using VMS, 2-8; DCL Concepts, 3-4 
Master file directory 
See MFD 
Match size 

specifying with DIFFERENCES command • DCL 
Dictionary, DCL1-155 

Maximum record size • Sort/Merge, SORT-43 
MEC file • DSR Ref, 5-3 

with DSR • Text Processing, 3-49 
Media 

See also Disk 
See also Magnetic tape 
/MEDIA_FORMAT qualifer 

for INITIALIZE command • DCL Dictionary, 
DCL1-246, DCL2-177 
Member number 

in UIC • Using VMS, 7-2 
Memo 

formatting with DSR • Text Processing, 3-12 
Memory 
displaying 

error count for • DCL Dictionary, DCL2-279 
displaying availability and use of 

process balance slots • DCL Dictionary, 
DCL2-292 

process entry slots • DCL Dictionary, 
DCL2-292 

modifying* DCL Dictionary, DCL1-147 
replacing virtual contents • DCL Dictionary, 
DCL1-147 

virtual examination of contents • DCL Dictionary, 
DCL1-209 

Memory allocation file 

brief format • DCL Dictionary, DCL1-386 
cross-reference format • DCL Dictionary, 
DCL1-386 

full format* DCL Dictionary, DCL1-387 
Menu entries • EVE Ref, 1-2 
MERGE command* Using VMS, 1—37, 1—42; DCL 
Dictionary, DCL1-405 
See also Sort/Merge Utility 
Merging 

of DIFFERENCES • DCL Dictionary, DCL1-155 
of queues • DCL Dictionary, DCL1-46 
Message 

leaving a • Phone, PHONE-17 
sending to terminal • DCL Dictionary, DCL2-38 
MESSAGE command • DCL Dictionary, DCL1-406 


Message count 

correcting with READ/NEW • Mail, MAIL-15 
Message file 

setting format* DCL Dictionary, DCL2-179 
Messages 

answering • Mail, MAIL-26, MAIL-73 
copying to a file • Mail, MAIL—32, MAIL—48 
copying to another folder • Mail, MAIL-32 
creating a subdirectory for • Mail, MAIL—12 
deleting • Mail, MAIL-39, MAIL-66 
displaying • Mail, MAIL-35 
editing • Mail, MAIL-44 
moving between folders • Mail, MAIL-39 
moving to a folder • Mail, MAIL-50, MAIL-60 
organizing with folders • Mail, MAIL-9 
printing • Mail, MAIL-63, MAIL-91 
reading • Mail, MAIL-2, MAIL-30, MAIL-69 
recovering • Mail, MAIL-39 
searching • Mail, MAIL-75 
selecting • Mail, MAIL-76 
sending • Mail, MAIL-57, MAIL-79 
Messages buffer 

displaying contents of (EVE) • Text Processing, 
1-52 

/MESSAGES qualifier* DSR Ref, 4-16 
Message window 

description of (EVE) • Text Processing, 1-2 
displaying contents of Messages buffer (EVE) • 
Text Processing, 1-51 
MEX file • DSR Ref, 6-6 
generating • DSR Ref, 6-6 
with DSR • Text Processing, 3-53 
MFD (master file directory) • Using VMS, 2-1, 2-6; 
Files and Devices, A-2 
See also Directory structure 
definition • DCL Concepts, 3-7 
displaying contents of • Using VMS, 2-21 
$$Minutes • DSR Ref, 3-18 
Modem • Using VMS, 1-4 
Mode of buffer 

See also CHANGE MODE command 
commands and keys affected • EVE Ref, EVE-27 
Modes 

of transferring files • DCL Dictionary, DCL1-215 
MODIFIABLE keyword 

SET BUFFER command (EVE) • Text Processing, 
1-50 

/MODIFY qualifier • EVE Ref, 1-13 
Module header records 

analyzing in object file • DCL Dictionary, DCL1-28 
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Module object 

analyzing • DCL Dictionary, DCL1-26 

end-of-file records • DCL Dictionary, DCL1-27 
Module traceback records 

analyzing in object file • DCL Dictionary, DCL1-29 
MONITOR command • DCL Dictionary, DCL1-407 
$$Month • DSR Ref, 3-18 

MOUNT command • Using VMS, 2-10, 7-11; Files 
and Devices, 2-6, 3-6, 3-20; DCL Concepts, 

3-6, 8-7; DCL Dictionary, DCL1-408 
and DEASSIGN command • DCL Dictionary, 
DCL1-104 

and DISMOUNT command • DCL Dictionary, 
DCL1-170 

/ASSIST qualifier • Files and Devices, 3-7 
/AUTOMATIC qualifier • Files and Devices, 3-18 
/BIND qualifier • Files and Devices, 3-9 
/BLOCKSIZE qualifier • Files and Devices, 3-12, 
5—8, B—14 

/CACHE=TAPE_DATA qualifier • Files and 
Devices, 3-14 

/FOREIGN qualifier • Files and Devices, 3-13, 

4-13, 5-6 

/GROUP qualifier* Files and Devices, 3-7 
/HDR3 qualifier • Files and Devices, 3-15 
/INITIALIZE qualifier • Files and Devices, 3-18 
magnetic tape • Files and Devices, 5-2 
/NOLABEL qualifier • Files and Devices, 5-8 
/OVERRIDE qualifier • Files and Devices, 3-13, 

4- 16 

/OWNERJJIC qualifier • Files and Devices, 3-14 
protection codes • Files and Devices, 4-11 
/PROTECTION qualifier • Files and Devices, 3-14 
qualifiers • Files and Devices, 3-12 
/RECORDSIZE qualifier • Files and Devices, 3-15, 

5- 8, B-15 

specifying logical names • Files and Devices, 3-6 
specifying record size • Files and Devices, 3-15 
specifying UIC • Files and Devices, 3-14 
/SYSTEM qualifier • Files and Devices, 3-7 
Mount request • Files and Devices, 3-7 
Mouse 

defining buttons • EVE Ref, 1-28 
to select text* EVE Ref, EVE-143 
with status line indicators • EVE Ref, EVE-25, 
EVE-27, EVE-92, EVE-151 
"move" • EDT Ref, EDT-296 
See also Cursor movement 
MOVE BY LINE command • EVE Ref, EVE-84 
moving the cursor with (EVE) • Text Processing, 
1-9 


MOVE BY PAGE command • Using VMS, 8-9; EVE 
Ref, EVE-85 

moving the cursor with (EVE) • Text Processing, 
1-9 

with WPS keypad • EVE Ref, EVE-186 
MOVE BY WORD command • Using VMS, 8-9; EVE 
Ref, EVE-86 

moving the cursor with (EVE) • Text Processing, 
1-9 

MOVE command • VMS Intro, 1-12; Using VMS, 
1-33; Mail, MAIL-10, MAIL-60; EDT Ref, 
EDT-150 

See also FILE command 
EDT editor • Text Processing, 2-29 
MOVE DOWN command • EVE Ref, EVE-87 
MOVE LEFT command • EVE Ref, EVE-88 
MOVE RIGHT command • EVE Ref, EVE-89 
MOVE UP command • EVE Ref, EVE-90 
Moving text 

APPEND • EDT Ref, EDT-261 
buffer specifier 

line mode • EDT Ref, EDT-120 
COPY • EDT Ref, EDT-125 
CUT • EDT Ref, EDT-50, EDT-275 
/DUPLICATE qualifier • EDT Ref, EDT-137 
INCLUDE • EDT Ref, EDT-147 
MOVE • EDT Ref, EDT-150 
OPEN LINE • EDT Ref, EDT-80 
PASTE • EDT Ref, EDT-20, EDT-84, EDT-298 
SEL (select) • EDT Ref, EDT-307 
SELECT • EDT Ref, EDT-95 
string specifier 

keypad mode • EDT Ref, EDT-99 
TOP • EDT Ref, EDT-325 

MTAACP (magnetic tape ancillary control process) • 
Files and Devices, B-1 
Multifile/multivolume configuration • Files and 
Devices, B-7 

Multifile/single-volume configuration • Files and 
Devices, B-5 

Multinational characters • DSR Ref, 2-14 
Multinational collating sequence • Using VMS, 1-40 
Multiple buffers 

editing with EVE • Text Processing, 1-56 
Multiple file specifications 

in a parameter list* DCL Concepts, 3-16 
Multiple keys 

number allowed • Sort/Merge, SORT-28 
rules for specifying • Sort/Merge, SORT-28 
Multivolume file • Files and Devices, 1-7 
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N 


"n" specifier 

with /DUPLICATE qualifier • EDT Ref, EDT-137 
with SET WRAP • EDT Ref EDT-204 
with TAB ADJUST • EDT Ref EDT-249 
Name 

See also Logical name 

detached process • DCL Dictionary, DCL2-55 

generic device* DCL Dictionary, DCL1-15 

logical 

canceling • DCL Dictionary, DCL1-104 
deassigning • DCL Dictionary, DCL1-58 
subprocess • DCL Dictionary, DCL2-55 
symbol definition • DCL Dictionary, DCL1-1, 
DCL1-5 

Named directory specification 

definition • Using VMS, 2-8; DCL Concepts, 3-9 
format in a file specification • Using VMS, 2-8; 
DCL Concepts, 3-9 

rules for entering • Using VMS, 2-8; DCL 
Concepts, 3-9 

Names for keys • EVE Ref 1-25 

NCS command • DCL Dictionary, DCL2-1 

.NE. 

in a numeric comparison • DCL Concepts, 6-7 
.NES. 

in a string comparison • DCL Concepts, 6-2 
Nested command procedure • Command Procedures, 
1-7 

default Ctrl/Y action • Command Procedures, 7-9 
Network • VMS Intro, 3-1 

executing programs across • Using VMS, 3-4 
link • Using VMS, 1-4 
login • Using VMS, 1-3 
logout • Using VMS, 1-4 
sending mail over* Using VMS, 1-28 
use with • Phone, PHONE-8 
Network file specification 
See also File specification 
conventional format • DCL Concepts, 3-3 
foreign file format • DCL Concepts, 3-3 
task specification string • DCL Concepts, 3-3 
Network HSC node 

connecting to a remote HSC • DCL Dictionary, 
DCL2-173 

connecting to a storage controller • DCL 
Dictionary, DCL2-171 
Networking • Mail, MAIL-6 


Network node 

See also Access control string 
See also Node name 
See also SET HOST command 
See also SET HOST/DUP command 
See also SET HOST/HSC command 
accessing a local node • Using VMS, 2—11; DCL 
Concepts, 3-2 

accessing a remote node • Using VMS, 2-11; 

DCL Concepts, 3-2 

accessing a remote node with an access control 
string • DCL Concepts, 3-2 
and batch jobs • DCL Dictionary, DCL2—382 
connecting to a remote processor • DCL 
Dictionary, DCL2-149 
NEW command • EVE Ref EVE-91 

for buffer manipulation (EVE) • Text Processing, 
1-48 

writing buffer to a file using (EVE) • Text 
Processing, 1-54 

NEXT BUFFER command • EVE Ref EVE-92 
for buffer manipulation (EVE) • Text Processing, 
1—48 

NEXT command • Mail, MAIL-62; EDT Ref 
EDT-152 

See also SUBSTITUTE NEXT command 
NEXT SCREEN command 

moving the cursor with (EVE) • Text Processing, 
1-9 

NEXT SCREEN command/BEGIN • EVE Ref 
EVE-93 

NEXT SCREEN command/END • EVE Ref EVE-93 
Next Screen key 
See also +Sect key 

on LK201 keyboard • EDT Ref EDT-93 
NEXT WINDOW command • Using VMS, 8-9, 8-35; 
EVE Ref EVE-94 
EVE editor* Text Processing, 1-56 
in window environment (EVE) • Text Processing, 
1-55 

moving the cursor with (EVE) • Text Processing, 
1-9 

.NO AUTOJUSTIFY command • DSR Ref 2-3 
.NO AUTOPARAGRAPH command • DSR Ref 2-4 
.NO AUTOSUBTITLE command • Text Processing, 
3-42; DSR Ref 2-6 

.NO AUTOTABLE command • DSR Ref 2-7 
/NOBOLD qualifier* DSR Ref 4-6 
/NOCHANGE_BARS qualifier • DSR Ref 4-7 
.NO CONTROL CHARACTERS command • DSR Ref 
2-14 

.NO DATE command • DSR Ref 2-15 
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Node ♦ VMS Intro, 3-1 
/NODEBUG qualifier • DSR Ref, 4-8 
Node field 

default value • Using VMS, 2-12; DCL Concepts, 
3-22 

definition • DCL Concepts, 3-1 
in full file specification • Using VMS, 2-11 
Node name • Mail, MAIL-6, MAIL-7, MAIL-15 
See also Access control string 
See also Node field 
definition • Using VMS, 2-11 
format in a file specification • Using VMS, 2-11; 
DCL Concepts, 3-2 

rules for entering • Using VMS, 2-11; DCL 
Concepts, 3-2 

using a logical name • Using VMS, 4-16; DCL 
Concepts, 4-21 to 4-23 
Node names 

displaying • DCL Dictionary, DCL2-331 
Node specification • VMS Intro, 3-1 
/NOECHO qualifier* VMS Intro, 6-14 
.NO FILL command • Text Processing, 3-15; DSR 
Ref, 2-39 

.NO FLAGS ACCEPT command • DSR Ref, 2-41 
.NO FLAGS BOLD command • DSR Ref, 2-43 
.NO FLAGS BREAK command • DSR Ref, 2-44 
.NO FLAGS CAPITALIZE command • DSR Ref, 2-45 
.NO FLAGS COMMENT command • DSR Ref, 2-46 
.NO FLAGS CONTROL command • DSR Ref, 2-47 
.NO FLAGS HYPHENATE command • DSR Ref, 

2—48 

.NO FLAGS INDEX command • DSR Ref, 2-49 
.NO FLAGS LOWERCASE command • DSR Ref, 
2-50 

.NO FLAGS OVERSTRIKE command • DSR Ref, 
2-51 

.NO FLAGS PERIOD command • DSR Ref, 2-52 
.NO FLAGS SPACE command • DSR Ref, 2-53 
.NO FLAGS SUBINDEX command • DSR Ref, 2-54 
.NO FUGS SUBSTITUTE command • DSR Ref, 
2-55 

.NO FUGS UNDERLINE command • DSR Ref, 2-56 
.NO FUGS UPPERCASE command • DSR Ref, 
2-57 

/NOHEADER qualifier • Mail, MAIL-3 
.NO HEADERS command • DSR Ref, 2-63 
/NOINTERMEDIATE qualifier • DSR Ref, 4-14 
.NO JUSTIFY command • Text Processing, 3-16; 
DSR Ref, 2-71 

.NO KEEP command • DSR Ref, 2-73 
Nokeypad commands 

list of by function • EDT Ref, EDT-257 


Nokeypad command specifier 

with CHANGE • EDT Ref, EDT-122 
Nokeypad mode • EDT Ref, EDT-6 
See also SHOW KEYPAD command 
changing to line mode • EDT Ref, EDT-1 
EDT • Text Processing, 2-2, 2-31 
screen editor • EDT Ref, EDT-6 
/NOLOG qualifier • DSR Ref, 4-14, 6-8 
Noncommand image • Using VMS, 3-4 
Nondefinable keys • EVE Ref, 1-27 
Nonfile device 

protection • Using VMS, 7-12 
Noninteractive mode 

definition • DCL Concepts, 1-1 
Nonpaged dynamic memory 

displaying availability and use of • DCL Dictionary, 
DCL2-292 

Nonprinting character 

inserting escape characters (EVE) • Text 
Processing, 1-13 
Nonprinting characters 

with QUOTE command • EVE Ref, EVE-107 
Nonprivileged command image 

interrupting and canceling • Using VMS, 1-20 to 

1- 21; DCL Concepts, 2-2 

.NO NUMBER command • Text Processing, 3-37; 
DSR Ref, 2-91 

/NOOUTPUT qualifier • DSR Ref, 4-17, 6-8 
/NOPAGE_NUMBERS qualifier • DSR Ref, 6-8 
.NO PAGING command • DSR Ref, 2-97 
/NOPAUSE qualifier • DSR Ref, 4-19 
.NO PERIOD command • DSR Ref, 2-100 
/NOREQUIRE qualifier • DSR Ref, 6-9 
/NORESERVE qualifier • DSR Ref, 6-9 
/NORIGHT qualifier • DSR Ref, 4-21 
/NOSEQUENCE qualifier • DSR Ref, 4-23 
/NOSIMUUTE qualifier • DSR Ref, 4-24 
.NO SPACE command • DSR Ref, 2-84, A-5 
.NO SUBTITLE command • DSR Ref, 2-120 
.NOT. 

in a logical operation • DCL Concepts, 6-8 
Note 

creating with DSR • Text Processing, 3-43 
.NOTE command • DSR Ref, 2-86 
Not equal to operator 

symbol for in expressions • Command Procedures, 

2- 13 

Notes 

inserting in text • DSR Ref, A-3 
/NOTYPE qualifier • EDT Ref, EDT-153 
with SUBSTITUTE • EDT Ref, EDT-243 
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/NOUNDERLINE qualifier • DSR Ref, 4-25 
/NOWRAP qualifier • VMS Intro, 6-16 
<null> • EDT Ref, EDT-154 
Null arguments • DSR Ref, 1-4 
Null value 

for file name • DCL Concepts, 3-16 
for file type • DCL Concepts, 3-16 
Number 

as fraction • Using VMS, 5-9 
assigning to a symbol • Using VMS, 5-8 
converting to a string value • Using VMS, 5-15; 

DCL Concepts, 6-12 
evaluation of • Using VMS, 5-3 
in an expression • Using VMS, 5-13 
integer values recognized by DCL • Using VMS, 
5-8; DCL Concepts, 5-5 
internal storage of • Using VMS, 5-9 
.NUMBER APPENDIX command • DSR Ref, 2-87 
.NUMBER CHAPTER command • DSR Ref, 2-88 
.NUMBER LEVEL command • DSR Ref, 2-89 
.NUMBER LIST command • DSR Ref, 2-90 
.NUMBER PAGE command • DSR Ref, 2-91 
.NUMBER RUNNING command • DSR Ref, 2-92 
Number specifier 

with ASC • EDT Ref, EDT-262 
with SET LINES • EDT Ref, EDT-181 
with SET TAB • EDT Ref, EDT-196 
.NUMBER SUBPAGE command • DSR Ref, 2-93 
Numeric expression 

comparison operators • DCL Concepts, 6-7 
definition • DCL Concepts, 6-6 
examples • DCL Concepts, 6-1, 6-7, 6-8 
Numeric keyboard • EDT Ref, EDT-2 
/NUMERIC.KEYPAD qualifier* VMS Intro, 6-15 


o 


Object 

See System object 
Object file 

analyzing • DCL Dictionary, DCL1-26 
identifying errors • DCL Dictionary, DCL1-26 
Object module • VMS Intro, 4-1 

analyzing • DCL Dictionary, DCL1-26 

end-of-file records* DCL Dictionary, DCL1-27 
linking • VMS Intro, 4-8 

Object module library* DCL Dictionary, DCL1-28 
Octal dump* DCL Dictionary, DCL1-176 


Octal numbers 

in a numeric UIC • DCL Concepts, 8-2 
in a UIC directory specification • DCL Concepts, 
3-9 

Offset 

definition • Using VMS, 5—16; DCL Concepts, 6-3 
/OMIT qualifier • Sort/Merge, SORT-68 
ON command • Using VMS, 6-30; DCL Dictionary, 
DCL2-2 to DCL2-4 

and command procedure • DCL Dictionary, 
DCL2-2 

and CONTINUE command • DCL Dictionary, 
DCL1-63 

and Ctrl/Y • DCL Dictionary, DCL2-2 
error in command procedure • DCL Dictionary, 
DCL2-2 

for error handling • Command Procedures, 7-4 
interrupt of command procedure • DCL Dictionary, 
DCL2-2 

specifying severity level • Command Procedures, 
7-4 

with Ctrl/Y • Command Procedures, 7-7 
with severity level • Command Procedures, 7-2 
ON CONTROL_Y command • Using VMS, 6-31 
ONE WINDOW command • Using VMS, 8-35; EVE 
Ref, EVE-95 

EVE editor* Text Processing, 1-56 
in window environment (EVE) • Text Processing, 
1-55 

Online help • DCL Dictionary, DCL1-231 
OPCOM 

enabling terminal to receive messages from • DCL 
Dictionary, DCL2-40 

messages to users from • DCL Dictionary, 
DCL2-47 

OPCOM (Operator Communication Facility) message 
continuation volume request • Files and Devices, 
5-4 

Open 

displaying 

names of open files • DCL Dictionary, 
DCL2-265 

file • DCL Dictionary, DCL2-5 
OPEN command • Using VMS, 6-13; Command 
Procedures, 6-1; DCL Dictionary, DCL2-5 to 
DCL2-8; EVE Ref, EVE-96 
See also CLOSE command 
See also GET FILE command 
See also READ command 
See also WRITE command 
appending records to an existing file • Command 
Procedures, 6-9 
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OPEN command (Cont.) 

creating a new buffer with (EVE) • Text Processing, 
1-52 

creating a new output file • Command Procedures, 
6—8 

for buffer manipulation (EVE) • Text Processing, 
1-47 

opening a file for reading • Command Procedures, 
6-2 

opening a file for writing • Command Procedures, 
6—2 

opening a shareable file • Command Procedures, 
6-3 

reading file into buffer with (EVE) • Text 
Processing, 1-54 

OPEN LINE command • Using VMS, 8-56; EDT Ref, 
EDT-80 

See also Moving text 
OPENLINE keypad function 
EDT • Text Processing, 2-18 
OPEN SELECTED command • EVE Ref EVE-97 
creating a new buffer with (EVE) • Text Processing, 
1-52 

for buffer manipulation (EVE) • Text Processing, 
1—48 

reading file into buffer with (EVE) • Text 
Processing, 1-54 

using with search string (EVE) • Text Processing, 
1-20 
Operand 

See also Expression 
See also Operator 
definition • DCL Concepts, 5-7, 6-1 
example • DCL Concepts, 6-1 
Operator 

See also Expression 

See also Operand 

See also REQUEST command 

character string • Using VMS, 5-12 

concatenation • Using VMS, 5-12 

definition • Using VMS, 5-11; DCL Concepts, 

5— 7, 6—1 

disabling status • DCL Dictionary, DCL2-40 
enabling status ♦ DCL Dictionary, DCL2-40 
example • DCL Concepts, 6-1 
in expressions • Command Procedures, 2-12 
log file closing • DCL Dictionary, DCL2-41 
log file opening • DCL Dictionary, DCL2-41 
logical • Using VMS, 5-12, 5-15; DCL Concepts, 

6 - 8 

numeric • Using VMS, 5-13; DCL Concepts, 6-7 
numeric comparison • DCL Concepts, 6-7 


Operator (Cont.) 

order of evaluation • Using VMS, 5-18; DCL 
Concepts, 6-10 
reduction • Using VMS, 5-12 
requesting reply from • DCL Dictionary, DCL2-47 
rules for data types • Command Procedures, 2-13 
sending message to • DCL Dictionary, DCL2-47 
string • DCL Concepts, 6-1 
string comparison • Using VMS, 5-11; DCL 
Concepts, 6-2 

string concatenation • DCL Concepts, 6-2 
string reduction • DCL Concepts, 6-2 
Operator Communication Facility 
See OPCOM 

Operators in condition tests • Sort/Merge, SORT-57 
Optimizing SORT 

system manager options • Sort/Merge, SORT-8 
user options • Sort/Merge, SORT-7 
Optional keypad keys 

using with search string (EVE) • Text Processing, 
1-20 
Options file 

CONVERT/DOCUMENT command • DCL 
Dictionary, DCL1-67 

.OR. 

in a logical operation • DCL Concepts, 6-9 
OTHER WINDOW command • Using VMS, 8-35; 
EVE Ref EVE-98 

See also NEXT WINDOW command 
Output 

creating a new file • Command Procedures, 6-8 
default for batch job command procedures • 
Command Procedures, 3-8 
default for interactive command procedures • 
Command Procedures, 3-8 
directing in a command procedure • Command 
Procedures, 3-7 

redefining for interactive command procedures • 
Command Procedures, 3-8 
suppressing by redefining SYS$OUTPUT • 
Command Procedures, 3-8 
to a terminal • Command Procedures, 3-14 
Output file 

EVE • DCL Dictionary, DCL1-197 
on exiting • EVE Ref EVE-52 
organization • Sort/Merge, SORT-3 

defaults • Sort/Merge, SORT-45, SORT-47, 
SORT-48 

specifying • Sort/Merge, SORT-45, SORT-47, 
SORT-48 
preallocation 

for optimization • Sort/Merge, SORT-40 
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Output file (Cont.) 

qualifiers • Sort/Merge, SORT-3 

/ALLOCATION • Sort/Merge, SORT-40 
/BUCKET_SIZE • Sort/Merge, SORT-41 
/CONTIGUOUS • Sort/Merge, SORT-42 
/FORMAT • Sort/Merge, SORT-43 
/INDEXED_SEQUENTIAL • Sort/Merge, 
SORT-45 

/OVERLAY • Sort/Merge, SORT-46 
/RELATIVE • Sort/Merge, SORT-47 
/SEQUENTIAL • Sort/Merge, SORT-48 
reformatting record fields • Sort/Merge, SORT-61 
VAXTPU • DCL Dictionary, DCL1-197 
with /OUTPUT qualifier* EVE Ref, 1-14 
with the SAVE FILE AS command • EVE Ref, 
EVE-140 

with the SAVE FILE command • EVE Ref, 
EVE-139 

with WRITE FILE command • EVE Ref, EVE—250 
Output file specifications for qualifiers 
/EXECUTABLE • DCL Concepts, 1-10 
file naming conventions • DCL Concepts, 1-10 to 
1-11 

/LIST • DCL Concepts, 1-10 
/OBJECT • DCL Concepts, 1-10 
/OUTPUT qualifier • DSR Ref, 4-17, 5-4, 6-8; EVE 
Ref, 1-14 
Output stream 

defining for created process • DCL Dictionary, 
DCL2-53 

definition • Using VMS, 4-6; DCL Concepts, 4-5 
Overlay 

in a string assignment • DCL Concepts, 6-3 
numeric • Using VMS, 5-16, 5-17; DCL 
Concepts, 6-9 

Overlaying files using the COPY command • DCL 
Dictionary, DCL1-79 

/OVERLAY qualifier • Sort/Merge, SORT-46 
Override 

default command interpreter • DCL Dictionary, 
DCL1-392 

magnetic tape overwrite protection ♦ DCL 
Dictionary, DCL1-246 
owner identification field • DCL Dictionary, 
DCL1-246 

Overstrike flag • DSR Ref, 3-14 
recognizing • DSR Ref, 2-51 
Overstrike mode 

definition • DCL Concepts, 2-4 
editing command line in • Using VMS, 1-23 
EVE editor* Text Processing, 1-12 
using EVE in • Using VMS, 8-11 


OVERSTRIKE MODE command • EVE Ref, EVE-99 
EVE editor • Text Processing, 1-13 
/OVERSTRIKE qualifier* VMS Intro, 6-15 
Overstriking • DSR Ref, 2-32, 3-14 
See also Emphasizing text 
example • DSR Ref, 3-14 
Overwrite protection 

overriding on magnetic tape • DCL Dictionary, 
DCL1-246 
OWNER category 

definition • DCL Concepts, 8-3 
Owner identifier field 

writing characters to • DCL Dictionary, DCL1-245 
Owner ownership category • Using VMS, 7-3 
Ownership 

display • Using VMS, 7—12; Files and Devices, 
2-13 

object • Using VMS, 7-3 

specifying for volume • DCL Dictionary, DCL1—246 


P 


P0 image 

creating • DCL Dictionary, DCL1-388 
PI through P8 • Using VMS, 5-3; DCL Concepts, 
5—1 

Pad character • Sort/Merge, SORT-69 
/PAD qualifier • Sort/Merge, SORT-69 
Page break 

with INSERT PAGE BREAK command • EVE Ref, 
EVE-78 

with MOVE BY PAGE • EVE Ref, EVE-85 
with PAGINATE command • EVE Ref, EVE-100 
with WPS keypad • EVE Ref, EVE-186 
Page breaks • DSR Ref, 2-124 
PAGE command • Using VMS, 8-57; EDT Ref, 
EDT-82 

See also Cursor movement 
.PAGE command • DSR Ref, 2-94 
Paged dynamic memory 

displaying availability and use of • DCL Dictionary, 
DCL2-292 

Page formatting • DSR Ref, 2-94, 2-97 
commands • DSR Ref, A-1 
controlling lines per page • DSR Ref, 4-13 
controlling numbering • DSR Ref, A-1 
controlling size • DSR Ref, A-1 
controlling subpaging • DSR Ref, A-1 
header • DSR Ref, 5-5 
inserting blank lines • DSR Ref, 4-12 
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Page formatting (Cont.) 

list of options • DSR Ref, 6-8 
number references • DSR Ref, 6-8 
running header • DSR Ref, A-1 
size of page • DSR Ref, 2-95 
starting new page • DSR Ref, 2-119 
PAGE keypad function 

EDT • Text Processing, 2-12 
Page number 

adjusting with DSR • Using VMS, 9-13 
letter (DSR) • Text Processing, 3-34 
Roman numeral (DSR) • Text Processing, 3-34 
suspending with DSR • Using VMS, 9-17 
Page numbering • DSR Ref, 2-24, 2-91, 2-119 
displaying • DSR Ref, 5-4 
merging in index • DSR Ref, 6-3 
range of • DSR Ref, 6-3 
running page numbers • DSR Ref, 2-92 
subpage • DSR Ref, 2-93 
subpage characters • DSR Ref, 2-25 
subpages • DSR Ref, 2-119 
Page size (DSR) • Text Processing, 3-17 
.PAGE SIZE command • Text Processing, 3-17; 

DSR Ref, 2-95 

/PAGES qualifier • DSR Ref, 4-18 
/PAGE_NUMBERS=option qualifier • DSR Ref, 6-8 
/PAGE_NUMBERS qualifier • DSR Ref, 5-4 
PAGINATE command • EVE Ref, EVE-100 

formatting text with (EVE) • Text Processing, 1-40 
with WPS keypad • EVE Ref, EVE-186 
Pagination 

keypad mode • EDT Ref, EDT-40 
.PAGING command • DSR Ref, 2-97 
Paper size 

A4 • DSR Ref, 4-9 
default 

LN01 • DSR Ref, 4-9 
LN01E • DSR Ref, 4-9 
LN03 • DSR Ref, 4-9 
European • DSR Ref, 4-9 
standard • DSR Ref, 4-9 
Paragraph 

with FILL commands • EVE Ref, EVE-59, EVE-61 
Paragraph boundaries • EVE Ref, 1-3 
.PARAGRAPH command • DSR Ref, 2-98 
Paragraph indent 

setting • EVE Ref, EVE-203 
with filling a range • EVE Ref, EVE-59, EVE-62 
with WPS Ruler key • EVE Ref, EVE-186 
Paragraphs 

formatting • DSR Ref, 2-4, 2-7, 2-98, 2-114, A-3 


Paragraphs (Cont.) 

formatting with DSR • Using VMS, 9-6 
Parameter 

case value of strings • Command Procedures, 3-2 
DCL syntax line • DCL Concepts, 1-3 
definition • VMS Intro, 1-4; Using VMS, 1-9; 

DCL Concepts, 1-3 

in DCL command line • Using VMS, 1-8 
in file specification • Using VMS, 2-13 
logical names in file specification values • DCL 
Concepts, 1-6 

null • Command Procedures, 3-2 
passing to a command procedure • Command 
Procedures, 3-1; Using VMS, 5-3, 6-7; 

DCL Concepts, 5-1; DCL Dictionary, 
DCL1-9, DCL1-52 

passing to batch job • DCL Dictionary, DCL2-381 
rules for entering • Using VMS, 1-11 
specifying for command procedures • DCL 
Dictionary, DCL1-9 

syntax • Using VMS, 1-11; DCL Concepts, 1-6 
use of* VMS Intro, 1-4 
using a file specification as a value • DCL 
Concepts, 1-6 
Parameter list 

defaults for multiple file specifications • DCL 
Concepts, 3-16 

multiple file specifications • DCL Concepts, 3-16 
to 3-17 

syntax • Using VMS, 1-12; DCL Concepts, 1-6 
Parameter qualifier 

definition • Using VMS, 1-13; DCL Concepts, 1-7 
/PARAMETERS qualifier* VMS Intro, 5-11 
Parent process 

definition • Using VMS, 3-1 
Password • VMS Intro, 1-1 

changing • Using VMS, 1-2; DCL Dictionary, 
DCL2-184 

creating • Using VMS, 1-2 
in access control string • Using VMS, 2-11 
in command procedure • Using VMS, 1-4 
in file • Using VMS, 1-4 
setting at login • DCL Dictionary, DCL1-392 
PASSWORD command • DCL Dictionary, DCL2-9 to 
DCL2-10 

PASTE command • Using VMS, 8-65; EVE Ref, 
EVE-101 

See also INSERT HERE command 

See also Moving text 

keypad mode • EDT Ref, EDT-84 

moving text with (EVE) • Text Processing, 1-18 

nokeypad mode • EDT Ref, EDT-298 
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PASTE key 

EDT • Text Processing, 2-18 
PATCH command • DCL Dictionary, DCL2-11 
Patch text records 

analyzing • DCL Dictionary, DCL1-24 
Patch Utility (PATCH) 

changing code in • DCL Dictionary, DCL2-11 
invoking • DCL Dictionary, DCL2-11 
/PAUSE qualifier • DSR Ref, 4-19 
Pending bad block log file • Files and Devices, A-3 
Pending delete 

EVE editor* Text Processing, 1-25 
to disable • EVE Ref, EVE-200 
to enable • EVE Ref, EVE-205 
to restore text erased with • EVE Ref, EVE-129 
with DELETE command • EVE Ref, EVE-38 
Percent sign (%) 

wildcard • Files and Devices, 4-17 

in input file specifications • DCL Concepts, 
3-19 

rules for using • Using VMS, 2-15; DCL 
Concepts, 3-19 

with range specifier • EDT Ref, EDT-154 
.PERIOD command • DSR Ref, 2-100 
Period flag • DSR Ref, 3—15 
default • DSR Ref, 3-15 
recognizing • DSR Ref, 2-52 
Permanent buffers • EVE Ref, EVE-40 
/PERSON AL_NAME qualifier • Mail, MAIL-21 
PF1 key 

on VT100-series terminals • Using VMS, 8-17 
PHONE 

See Phone Utility 

PHONE command • DCL Dictionary, DCL2-12 
Phone Utility (PHONE) • VMS Intro, 1-15; Using 
VMS, 1-36; Phone, PHONE-3 
commands • Phone, PHONE-8 to PHONE-20 
conference call • Phone, PHONE-2 
control characters • Phone, PHONE-2 
invoking • Phone, PHONE-3 
qualifiers • Phone, PHONE-4 to PHONE-7 
terminating • Phone, PHONE-12 
Physical device name 

controller designation field • Using VMS, 2-9; 
DCL Concepts, 3-4 

device code field • Using VMS, 2-9; DCL 
Concepts, 3-4 

format in a file specification • Using VMS, 2-9; 
DCL Concepts, 3-4 

unit number field • Using VMS, 2-9; DCL 
Concepts, 3-4 


Physical memory 

displaying availability and use of • DCL Dictionary, 
DCL2-292 

PID (process identification) number 
and process context • Using VMS, 3-2 
Placing a call 
See Dialing 
Port 

displaying information • DCL Dictionary, DCL2—331 
PORTRAIT option • DSR Ref, 4-10 
Positional qualifier 

definition* Using VMS, 1-12; DCL Concepts, 1-7 
rules for entering • Using VMS, 1-13 
PostScript back-end converter 

processing options in • DCL Dictionary, DCL1-68 
PREVIOUS BUFFER command • EVE Ref, EVE-102 
PREVIOUS SCREEN command • EVE Ref, EVE-103 
moving the cursor with (EVE) • Text Processing, 
1-9 

PREVIOUS WINDOW command • Using VMS, 8-9, 
8-35; EVE Ref, EVE-104 
in window environment (EVE) • Text Processing, 
1-55 

moving the cursor with (EVE) • Text Processing, 
1-9 

Prev Screen key 
See also -Sect key 

on LK201 keyboard • EDT Ref, EDT-93 
Print 

command procedure in batch job log • DCL 
Dictionary, DCL2-237 
file • DCL Dictionary, DCL2-13 
PRINT command • VMS Intro, 1-14, 2-7, 6-1; Using 
VMS, 2-19; Mail, MAIL-63; DCL Dictionary, 
DCL2-13 to DCL2-22; EDT Ref, EDT-157 
Printer, system 

displaying default characteristics of • DCL 
Dictionary, DCL2-300 
Printer fonts 

European • DSR Ref, B-3 
standard • DSR Ref, B-3 
Printers 
LN01 

default values • DSR Ref, 4-21 
font kit • DSR Ref, B-1 
fonts • DSR Ref, 4-10 
LANDSCAPE option • DSR Ref, 4-9 
paper size • DSR Ref, 4-9 
PORTRAIT option • DSR Ref, 4-10 
printing files • DSR Ref, 4-9 
requirements • DSR Ref, B-1 
specifying page size • DSR Ref, 4-13 
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Printers 

LN01 (Cont.) 

underlining • DSR Ref, 4-11 
LN01E • DSR Ref, 4-9 

default values • DSR Ref, 4-21 
paper size • DSR Ref, 4-9 
printing files • DSR Ref, 4-9 
requirements • DSR Ref, B-1 
specifying page size • DSR Ref, 4-13 
LN03 • DSR Ref, 4-9 

default values • DSR Ref, 4-21 
fonts • DSR Ref, 4-10 
LANDSCAPE option • DSR Ref, 4-9 
paper size • DSR Ref, 4-9 
PORTRAIT option • DSR Ref, 4-10 
printing files • DSR Ref, 4-9 
specifying page size • DSR Ref, 4-13 
underlining • DSR Ref, 4-11 
Printing files • DSR Ref, 4-19, 4-20, 6-6 
DSR output file • DSR Ref, 1-5 
form feed • DSR Ref, 4-24 
on LN01 device • DSR Ref, 1-5 
on LN01E laser printer • DSR Ref, 4-9, B-1 
on LN01 laser printer* DSR Ref, 4-9, B-1 
on LN03 laser printer • DSR Ref, 4-9 
specifying output device • DSR Ref, 4-9 
Printing messages 

default print form • Mail, MAIL-91 
setting default queue • Mail, MAIL-97 
Print job • Using VMS, 2-18 
delaying • Using VMS, 2-19 
list of DCL commands to use with • Using VMS, 
2-19 

obtaining multiple copies of* Using VMS, 2-19 
priorities • Using VMS, 2-18 
Print queue 

and print job execution • Using VMS, 2-18 
changing entry • DCL Dictionary, DCL2-136 
controlling • Using VMS, 2-19 
creating • DCL Dictionary, DCL1-249 
definition • Using VMS, 2-18 
deleting ♦ DCL Dictionary, DCL1-143 
deleting entries* DCL Dictionary, DCL1-136 
displaying entries • DCL Dictionary, DCL2-275, 
DCL2-309 

establishing as spooled • DCL Dictionary, 
DCL2-123 

generic • Using VMS, 2-18 
initializing • DCL Dictionary, DCL1-249 
modifying characteristics of • DCL Dictionary, 
DCL2-187, DCL2-345 
starting • DCL Dictionary, DCL2-345 


Print queue (Cont.) 

terminal • Using VMS, 2-18 
Priority 

modifying process • DCL Dictionary, DCL2-191 
specifying for batch job • DCL Dictionary, 
DCL2-382 

specifying for detached process • DCL Dictionary, 
DCL2-59 

specifying for subprocess • DCL Dictionary, 
DCL2-59 
Private volume 
See Volume 
Privilege 

BYPASS • Files and Devices, 2-3 
displaying process • DCL Dictionary, DCL2-304 
displaying subprocess • DCL Dictionary, 
DCL2-304 

GRPPRV • Files and Devices, 2-1 
modifying process • DCL Dictionary, DCL2-191 
SYSNAM • Files and Devices, 2-6 
SYSPRV • Files and Devices, 2-1, 2-6, 3-9 
VOLPRO (volume protection override) • Files and 
Devices, 2-3, 3-4, 3-8 

Privileged command image • Using VMS, 1-20 
interrupting and executing • DCL Concepts, 2-3 
Privileges 

specifying for detached process • DCL Dictionary, 
DCL2-59 

specifying for subprocess • DCL Dictionary, 
DCL2-59 

Process • Using VMS, 3-1 
See also Subprocess 
and job tree • Using VMS, 3-3, 3-5 
attaching to another • Mail, MAIL-28 
checking status with Ctrl/T • VMS Intro, 1-7 
creating • Using VMS, 3-1 
definition of • Using VMS, 3-1 
detached • Using VMS, 7-3 

accounting • DCL Dictionary, DCL2-55 
assigning resource quota to • DCL Dictionary, 
DCL2-54 

creating with RUN command • DCL Dictionary, 
DCL2-53, DCL2-61 

defining attributes • DCL Dictionary, DCL2-54 
defining equivalence names for process- 
permanent logical names • DCL 
Dictionary, DCL2-53 

image hibernation • DCL Dictionary, DCL2-55 
naming • DCL Dictionary, DCL2-55 
scheduling wakeup • DCL Dictionary, 

DCL2-57 

specifying quotas • DCL Dictionary, DCL2-57 
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Process 

detached (Cont.) 

specifying working set • DCL Dictionary, 
DCL2-61 
displaying 

buffered I/O count • DCL Dictionary, 

DCL2-319 

characteristics of • DCL Dictionary, DCL2-302 
CPU time used • DCL Dictionary, DCL2—319 
current physical memory occupied • DCL 
Dictionary, DCL2-319 
current working set size • DCL Dictionary, 
DCL2-319 

information on • DCL Dictionary, DCL2-246 
names • DCL Dictionary, DCL2—331 
open file count • DCL Dictionary, DCL2—319 
page faults* DCL Dictionary, DCL2-319 
status • DCL Dictionary, DCL2-319 
updated information about • DCL Dictionary, 
DCL2-303 
hibernation 

with ATTACH command • DCL Dictionary, 
DCL1-49 
identification 

displaying • DCL Dictionary, DCL2—303 
image wakeup • DCL Dictionary, DCL2-55 
modifying characteristics of • DCL Dictionary, 
DCL2-191 

modifying working set default size • DCL 
Dictionary, DCL2-244 
name 

for detached process • DCL Dictionary, 
DCL2-59 

for subprocess • DCL Dictionary, DCL2—59 
placing in wait state • DCL Dictionary, DCL2-397 
priority 

for detached process • DCL Dictionary, 
DCL2-59 

for subprocess • DCL Dictionary, DCL2-59 
privilege 

displaying • DCL Dictionary, DCL2-304 
specifying for detached process • DCL 
Dictionary, DCL2-59 

specifying for subprocess • DCL Dictionary, 
DCL2-59 

quotas 

displaying • DCL Dictionary, DCL2-304 
setting default device and/or directory • DCL 
Dictionary, DCL2-121 
status 

displaying current • DCL Dictionary, 
DCL2-319 


Process 
swap mode 

enabling or disabling • DCL Dictionary, 
DCL2-193 
swapping 

for created process • DCL Dictionary, 

DCL2-60 

switching control of input stream to • DCL 
Dictionary, DCL1-49 

synchronizing with batch job • DCL Dictionary, 
DCL2-387 
system 

displaying list of processes • DCL Dictionary, 
DCL2-322 

types of • Using VMS, 3-1 
working set 

displaying quota and limit • DCL Dictionary, 
DCL2-335 
Process characteristics 

lexical functions used to save and restore • Using 
VMS, 6-34 

obtained from UAF • Using VMS, 1-3 
Process context • Using VMS, 3-1 

list of characteristics • Using VMS, 3-2 
Process directory logical name table 

default contents • Using VMS, 4-9; DCL 
Concepts, 4-8 
Process dump 

analysis of • DCL Dictionary, DCL1-30 
Process identification number 
See PID number 
Processing commands 

SET VERIFY • EDT Fief, EDT-202 
SHOW SUMMARY • EDT Ref, EDT-229 
SHOW VERIFY • EDT Ref, EDT-235 
Processing files • DSR Ref, 6-6 

creating binary files • DSR Ref, 4-14 
debugging • DSR Ref, 4-8, 4-23 
error messages • DSR Ref, 4-16 
merging • DSR Ref, 2-103 
preserving format items* DSR Ref, 2-106 
report • DSR Ref, 5-4 
resuming • DSR Ref, 4-19 
specifying output file • DSR Ref, 4-17 
specifying pages for output • DSR Ref, 4—18 
termination message • DSR Ref, 4-15 
Processing options 

in PostScript back-end converter • DCL Dictionary, 
DCL1-68 

in text back-end converter • DCL Dictionary, 
DCL1-67 
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Processing text 

RNO file • DSR Ref, 5-2 
Process logical name 

function in a job tree • Using VMS, 4-5; DCL 
Concepts, 4-5 
Process logical name table 

canceling entries* DCL Dictionary, DCL1-106 
default contents • Using VMS, 4-6; DCL 
Concepts, 4-5 

definition • Using VMS, 4-5; DCL Concepts, 4-5 
including logical name* DCL Dictionary, DCL1-41, 
DCL1-116 

logical name for • Using VMS, 4-5; DCL 
Concepts, 4-5 
Process-permanent files 

changing the default value of • Command 
Procedures, 2-7 

default logical names • DCL Concepts, 4-23 
definition • Command Procedures, 2-5 
SYS$COMMAND • Command Procedures, 2-6 
SYS$ERROR • Command Procedures, 2-6 
SYS$INPUT • Command Procedures, 2-6 
SYS$OUTPUT • Command Procedures, 2-6 
Process-permanent logical names 
list of-Using VMS, 4-17 
Process privilege 

and file access • Using VMS, 2-1 
and process context • Using VMS, 3-3 
/PROCESS qualifier • Sort/Merge, SORT-29, 
SORT-70 

Process rights identifier 

and process context • Using VMS, 3-3 
Profile • Mail, MAIL-72 
Program • VMS Intro, 2-1; Using VMS, 3-1 
as batch job • Using VMS, 3-8 
assembling • VMS Intro, 4-1 
command image • Using VMS, 3-4 
compiling • VMS Intro, 4-1 
continuing execution of • DCL Dictionary, DCL1-63 
creating • VMS Intro, 4-1 
debugging • VMS Intro, 4-10, 4-14 
definition • Using VMS, 3-3 
developing • VMS Intro, 4-3 
developing a BASIC • VMS Intro, 4-5 
developing a FORTRAN • VMS Intro, 4-6 
developing a MACRO* VMS Intro, 4-10 
executing • VMS Intro, 4-3; Using VMS, 3-3 
across network • Using VMS, 3-4 
marking beginning of input stream • DCL 
Dictionary, DCL1-111 

marking end of input stream • DCL Dictionary, 
DCL1-206 


Program (Cont.) 

noncommand image • Using VMS, 3-4 
resuming execution of • DCL Dictionary, DCL1-63 
running • VMS Intro, 4-9, 4-13 
using logical names in • VMS Intro, 4-14 
Prompt* VMS Intro, 1-3 

displaying in command procedure • DCL 
Dictionary, DCL1-262 

in a command line • Using VMS, 1-11; DCL 
Concepts, 1-4 
Prompt type specifier 

with SET PROMPT • EDT Ref, EDT-186 
with SHOW PROMPT • EDT Ref, EDT-223 
Protecting files • Mail, MAIL-12 
Protection • Using VMS, 7-1 
See also ACL-based protection 
See also UlC-based protection 
access category 

summary of • Files and Devices, 2-1 
ACL-based • Using VMS, 7-6; Files and Devices, 
2-3 

categories of • Files and Devices, 2-1 
changing • Files and Devices, 2-6 
default* Using VMS, 7-5, 7-10; Files and 
Devices, 2-8 

changing • Files and Devices, 2-10 
default at disk initialization • DCL Dictionary, 
DCL1-244 

defining at directory creation • DCL Dictionary, 
DCL1-90 

defining at file creation • DCL Dictionary, DCL1-85 
device • Using VMS, 7-12; Files and Devices, 
2-13 

directory • Using VMS, 7-11; Files and Devices, 
2-12 

disk volume • Using VMS, 7-11; Files and 
Devices, 2-6 

disk volumes • DCL Dictionary, DCL1-247 
display • Files and Devices, 2-13 
displaying default • DCL Dictionary, DCL2-308 
displaying file • Using VMS, 7-12 
effect of privileges • DCL Concepts, 8-6 
establishing default*DCL Dictionary, DCL2-199 
file • Using VMS, 7-5, 7-9; Files and Devices, 
2-1, 2-8 

default • Files and Devices, 2-10 
directory • Files and Devices, 2-8, 2-11 
disk • Files and Devices, 2-8, 2-9 
magnetic tape • Files and Devices, 2-3, 2-8, 
2-12 

for interchange environments • Files and Devices, 
2-7 
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Protection (Cont.) 

format for object • Using VMS, 7-4 
magnetic tape volumes • DCL Dictionary, 
DCL1-247 

mail file • Files and Devices, 2-13 
mask • Files and Devices, 2-6 
modifying • DCL Dictionary, DCL2-196 
directory • DCL Dictionary, DCL2-196 
file • DCL Dictionary, DCL2-196 
modifying for device • DCL Dictionary, DCL2-200 
nonfile device* Using VMS, 7-12; Files and 
Devices, 2-14 

of copied files • Using VMS, 7-5 
of mail file • Using VMS, 7-11 
of shareable images • DCL Dictionary, DCL1-388 
UlC-based • Using VMS, 7-2; Files and Devices, 
2-1 

user data and devices • Using VMS, 7-5 
volume • Files and Devices, 2-1 

ANSI-labeled • Files and Devices, 2-4 
disk • Files and Devices, 2-5 
magnetic tape • Files and Devices, 2-5, 2-6 
Protection code 

changing • Files and Devices, 2-10 
definition • DCL Concepts, 8-5 
for magnetic tapes • Files and Devices, 3-14 
for volumes • Files and Devices, 3-14 
rules for entering • DCL Concepts, 8-5 
specifying • Files and Devices, 2-9 
syntax • DCL Concepts, 8-5 
Protection mask • Using VMS, 7-4 
Proxy login account 

definition • Using VMS, 2-12 
PSWRAP command • DCL Dictionary, DCL2-23 
Punctuation 

Indexing Utility • DSR Ref, 6-1 
period • DSR Ref, 2-52, 3-15 
space after • DSR Ref, 2-100 
PURGE command • VMS Intro, 2-5; Using VMS, 
2-17; Mail, MAIL-66; DCL Dictionary, 
DCL2-24 to DCL2-27 
Purging 

See also Deleting 

files • DCL Dictionary, DCL2-24 


Q 


Qualifier • EVE Ref, 1-7 

abbreviating • Using VMS, 1-12; DCL Concepts, 
1-12 " 


Qualifier (Cont.) 

/BRIEF 

with SUBSTITUTE • EDT Ref, EDT-243 
with TYPE • EDT Ref, EDT-251 
command • Using VMS, 1-12 
commonly used • DCL Concepts, 1—12 to 1—13 
DCL syntax line • DCL Concepts, 1-3 
default values • Using VMS, 1-13 
definition* VMS Intro, 1—4; Using VMS, 1—9; 

DCL Concepts, 1-3 
/DUPLICATE • EDT Ref, EDT-137 
with COPY • EDT Ref, EDT-125 
format* Using VMS, 1-13 
in DCL command line • Using VMS, 1-8 
/NOTYPE • EDT Ref, EDT-153 

with SUBSTITUTE • EDT Ref, EDT-243 
parameter • Using VMS, 1-13 
positional • Using VMS, 1-13 
/QUERY • EDT Ref, EDT-159 

with COPY • EDT Ref, EDT-125 
with DELETE • EDT Ref, EDT-135 
with MOVE • EDT Ref, EDT-150 
with SUBSTITUTE • EDT Ref, EDT-243 
rules for entering • Using VMS, 1-12; DCL 
Concepts, 1-7 
/SAVE • EDT Ref, EDT-169 

with EXIT • EDT Ref, EDT-138 
with QUIT • EDT Ref, EDT-161 
/SEQUENCE • EDT Ref, EDT-170 
with EXIT • EDT Ref, EDT-138 
with RESEQUENCE • EDT Ref, EDT-167 
with WRITE • EDT Ref, EDT-253 
/STAY • EDT Ref, EDT-240 

with TYPE • EDT Ref, EDT-251 
types of* Using VMS, 1—12, 1—13 
use of* VMS Intro, 1-4 
values 

date and time formats • Using VMS, 1-14 
rules for entering • Using VMS, 1-14 
types of* Using VMS, 1—14 
Qualifier format 

for position/negative qualifiers • DCL Concepts, 
1-7 

for qualifiers that override other qualifiers • DCL 
Concepts, 1-8 

for qualifiers that require values • DCL Concepts, 
1-8 

Qualifier types 

modifying a command • DCL Concepts, 1-7 
modifying a parameter • DCL Concepts, 1-7 
positional • DCL Concepts, 1-7 
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Qualifier values 

See also Output file specifications for qualifiers 
abbreviating • DCL Concepts, 1-10, 1-12 
date and time formats • DCL Concepts, 1-13 
default values • DCL Concepts, 1-7 
output file specifications • DCL Concepts, 1-10 
rules for entering • DCL Concepts, 1-9 
syntax • DCL Concepts, 1-9 
types • DCL Concepts, 1-9 
/QUERY qualifier • EDT Ref, EDT-159 
with COPY • EDT Ref, EDT-125 
with DELETE • EDT Ref, EDT-135 
with MOVE • EDT Ref, EDT-150 
with SUBSTITUTE • EDT Ref, EDT-243 
Queue • VMS Intro, 6-1 
See also Batch queue 
See also Print queue 

assigning logical name to • DCL Dictionary, 
DCL1-47 

assigning to devices • DCL Dictionary, DCL1-47 
batch • VMS Intro, 6-3; Using VMS, 3-8 

modifying characteristics of • DCL Dictionary, 
DCL2-345 
batch job 

displaying entries • DCL Dictionary, 
DCL2-275, DCL2-309 
entering command procedure in • DCL 
Dictionary, DCL2-376 
starting • DCL Dictionary, DCL2-345 
changing entry 

for batch • DCL Dictionary, DCL2-136 
for printer • DCL Dictionary, DCL2-136 
deassigning • DCL Dictionary, DCL1-109 
device 

displaying entries • DCL Dictionary, 
DCL2-275, DCL2-309 
execution (type) • DCL Dictionary, DCL1-251 
generic • Using VMS, 2-18; DCL Dictionary, 
DCL1-251 

initializing • DCL Dictionary, DCL1-249 
logical • DCL Dictionary, DCL1-252 
looking at jobs in • VMS Intro, 6-2, 6-3 
merging jobs • DCL Dictionary, DCL1-46 
print • VMS Intro, 6-1; Using VMS, 2-18 
removing jobs from • VMS Intro, 6-2, 6-4; DCL 
Dictionary, DCL1-46 
server* DCL Dictionary, DCL1-251 
setting default • Mail, MAIL-97 
showing default • Mail, MAIL-97 
starting • DCL Dictionary, DCL2-345 
stopping • DCL Dictionary, DCL2-345 
stopping jobs in • VMS Intro, 6-2, 6-4 


Queue (Cont.) 

symbiont* DCL Dictionary, DCL1-251 
terminal • Using VMS, 2-18 
types of • DCL Dictionary, DCL1-251 
Queue I/O services 

$QIO call • Files and Devices, B-1 
Queue protection 

access types • DCL Concepts, 8-7 
commands for setting • DCL Concepts, 8-7 
Quick copy • EVE Ref, 1-3 
QUIT command • Using VMS, 8-3, 8-48; Mail, 
MAIL-68; EVE Ref, EVE-105 to EVE-106 
EDT • Text Processing, 2-3 
EVE editor* Text Processing, 1-3 
line mode* EDT Ref, EDT-161 
nokeypad mode • EDT Ref, EDT-301 
Quota 

assigning to created process • DCL Dictionary, 
DCL2-54 

AST limit • DCL Dictionary, DCL2-55 
batch job 

working set • DCL Dictionary, DCL2-383 
CPU 

for created process • DCL Dictionary, 
DCL2-60 

of subprocesses process can create • DCL 
Dictionary, DCL2-60 

specifying for detached process • DCL Dictionary, 
DCL2-58, DCL2-59 

specifying for subprocess • DCL Dictionary, 
DCL2-58, DCL2-59 
working set 

for batch job • DCL Dictionary, DCL2-383 
modifying • DCL Dictionary, DCL2-244 
QUOTE command • EVE Ref, EVE-107 to EVE-108 
EVE editor* Text Processing, 1-13 


R 


R (replace) command • EDT Ref, EDT-302 
See also Replacing text 
Radix 

specifying in symbol assignment • Using VMS, 5-8 
Range 

commands and keys for found range • EVE Ref, 
EVE-64 

commands and keys for select range • EVE Ref, 
EVE-18, EVE-142 
Range-1 specifier 

with MOVE • EDT Ref, EDT-150 
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Range-2 specifier 

with MOVE* EDTRef, EDT—150 
Range specifier 

line mode • EDT Ref, EDT-162 
with <null> • EDT Ref, EDT-154 
with CHANGE • EDT Ref, EDT-122 
with DELETE • EDT Ref, EDT-135 
with FILL* EDT Ref, EDT-141 
with FIND • EDT Ref, EDT-143 
with INCLUDE • EDT Ref, EDT-147 
with INSERT ♦ EDT Ref, EDT-148 
with PRINT • EDT Ref, EDT-157 
with REPLACE • EDT Ref, EDT-165 
with RESEQUENCE* EDT Ref, EDT-167 
with SUBSTITUTE • EDT Ref, EDT-243 
with TAB ADJUST • EDT Ref, EDT-249 
with TYPE • EDT Ref, EDT-251 
with WRITE • EDT Ref, EDT-253 
RCW (record control word) • Files and Devices, B-14 
READ access 
See also Access 
for a device • DCL Concepts, 8-6 
for a directory • DCL Concepts, 8-8 
for a file • DCL Concepts, 8-9 
for a global section • DCL Concepts, 8—10 
for a logical name table • DCL Concepts, 8-10 
for a queue • DCL Concepts, 8-7 
for a volume • DCL Concepts, 8—7 
Read access category 

definition • Using VMS, 7-4 
READALL privilege • DCL Concepts, 8-6 
Read check 

with APPEND command • DCL Dictionary, 
DCL1-37 

with COPY command • DCL Dictionary, DCL1-79 
with INITIALIZE command • DCL Dictionary, 
DCL1-242 

READ command • VMS Intro, 1-11; Using 
VMS, 1-30 to 1-31, 5-5, 6-9, 6-15; Mail, 
MAIL-69; DCL Concepts, 5-1, 5-4; Command 
Procedures, 6-3; DCL Dictionary, DCL2-28 to 
DCL2-31 

See also OPEN command 
See also WRITE command 
case value of data obtained • Command 
Procedures, 3-4 

using to obtain data • Command Procedures, 3-4 
Reading 

new messages • Mail, MAIL-2 
old messages • Mail, MAIL-2 
Reading a record • Command Procedures, 6—3 
READ/NEW command • Mail, MAIL-15, MAIL-69 


Read operation • Files and Devices, 4—14 

continuation volumes • Files and Devices, 5—5 
disk • Files and Devices, 4-14 
magnetic tape • Files and Devices, 4—16, 4-19 
ANSI-labeled • Files and Devices, 4-17 
READ qualifier (OPEN command) • Command 
Procedures, 6-2 
Ready access 

for directories on disk* DCL Dictionary, DCL1-241 
/READ_ONLY qualifier • EVE Ref, 1-14 
Recall buffer • DCL Concepts, 2-6 
RECALL command • VMS Intro, 6-12; Using VMS, 
1-21; DCL Concepts, 2-6; DCL Dictionary, 
DCL2-32 to DCL2-33; EVE Ref, EVE-109 
/ALL qualifier* VMS Intro, 6-13 
Recalling commands • Using VMS, 1-21 to 1-22; 

DCL Concepts, 2-6 to 2-7 
Receiving mail 

over the network • Mail, MAIL-1 
Record 

appending to a file • Command Procedures, 6-9 
deleting in command procedure • Using VMS, 

6 — 17 

modifying in command procedure • Using VMS, 
6-16 

number of bytes in • Files and Devices, 3-15 
reading from a file • Command Procedures, 6-2 
updating • Command Procedures, 6-7 
writing from command procedure • Using VMS, 
6-17 

writing to a file • Command Procedures, 6—2 
Record control word 
See RCW 

Record format • Using VMS, 2-4 
changing • Sort/Merge, SORT-44 
default for • Sort/Merge, SORT-44 
fixed-length • Files and Devices, B-13 
reformatting • Sort/Merge, SORT-61 
variable-length • Files and Devices, B—13 
Record format field • Files and Devices, B-13 
Record length field • Files and Devices, B-15 
Record Management Sen/ices 
See VMS RMS 
Record-oriented device 

definition • Using VMS, 2-8; DCL Concepts, 3-4 
used as an output file specification • DCL 

Concepts, 3-5 
Records 
analyzing 

debugger information • DCL Dictionary, 
DCL1-27 

end-of-file • DCL Dictionary, DCL1-27 
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Records 

analyzing (Cont.) 

global symbol directory • DCL Dictionary, 
DCL1-27 

link option specification • DCL Dictionary, 
DCL1-28 

module header* DCL Dictionary, DCL1-28 
module traceback • DCL Dictionary, DCL1-28 
patch text’ DCL Dictionary, DCL1-24 
relocation • DCL Dictionary, DCL1-29 
comparing • DCL Dictionary, DCL1-151 
reading • DCL Dictionary, DCL2-28 
writing to file • DCL Dictionary, DCL2-399 
Record selection 

including records • Sort/Merge, SORT-64 
omitting records • Sort/Merge, SORT-68 
order of clauses • Sort/Merge, SORT-64, 
SORT-68 

Record sort* Using VMS, 1-37 

reasons for selecting • Sort/Merge, SORT-29 
specifying • Sort/Merge, SORT-70 
Recover 

for EDT* DCL Dictionary, DCL1-182 
RECOVER BUFFER ALL command • EVE Ref, 1-22, 
EVE-112 

EVE editor* Text Processing, 1-37 
RECOVER BUFFER command • EVE Ref, 1-21, 
EVE-110 to EVE-111 
EVE editor* Text Processing, 1-37 
Recovering files 

EVE editor* Text Processing, 1-37 
with RECOVER BUFFER commands (EVE) • Text 
Processing, 1-38 

with /RECOVER qualifier (EVE) • Text Processing, 
1-38 

/RECOVER qualifier • Using VMS, 8-23; EDT Ref, 
EDT-7; EVE Ref, 1-15 
EDT editor • Text Processing, 2-37 
Recovery from system failure • EVE Ref, 1-12 
EVE*DCL Dictionary, DCL1-198 
VAXTPU • DCL Dictionary, DCL1-198 
with buffer-change journaling • EVE Ref, 1-15 
with keystroke journaling • EVE Ref, 1-15 
Redefining keys • EDT Ref, EDT-8 
with DEFINE KEY • EDT Ref, EDT-10 
Redirecting output • DCL Concepts, 3-5 
Reduction 
See String 

REF (refresh) command • EDT Ref, EDT-303 
Reformatting the output record • Sort/Merge, 

SORT-61 

REFRESH command • EVE Ref, EVE-113 


Refreshing screen 

keypad mode • EDT Ref, EDT-44, EDT-48 
line mode* EDT Ref, EDT-128 
nokeypad mode • EDT Ref, EDT-303 
Reinitializing 

volumes • Files and Devices, 3-19 
REJECT command (PHONE) • VMS Intro, 1-17 
Rejecting a call • Phone, PHONE-19 
Relative file • Using VMS, 2-4 
/RELATIVE qualifier • Sort/Merge, SORT-47 
Relocation records 

analyzing in object file • DCL Dictionary, DCL1-29 
REMEMBER command • EVE Ref, EVE-114 
Remote node 

copying files to local node from • Using VMS, 2-14 
definition • Using VMS, 1-3 
displaying files on • Using VMS, 2-11 
printing file on • Using VMS, 2-19 
REMOVE command • Using VMS, 8-15; Mail, 
MAIL-72; EVE Ref, EVE-115 to EVE-116 
for buffer manipulation (EVE) • Text Processing, 
1-48 

moving text with (EVE) • Text Processing, 1—19 
using with search string (EVE) • Text Processing, 
1-20 
Remove key 

See also CUT command 
moving text with (EVE) • Text Processing, 1-18 
on LK201 Keyboard* EDT Ref, EDT-50 
Removing 

records • Mail, MAIL-72 

RENAME command • VMS Intro, 2-7; Using VMS, 
2-17; DCL Dictionary, DCL2-34 to DCL2-37 
Renaming files 

with the COPY command and the asterisk (*) 
wildcard • DCL Concepts, 3-19 
REPEAT command • Using VMS, 8-7; EVE Ref, 
EVE-117 to EVE-118 
EVE editor* Text Processing, 1-7 
.REPEAT command • DSR Ref, 2-102, A-5 
Repetitive substitution 

definition • DCL Concepts, 7-5 
REPLACE command • Using VMS, 8-20; EDT Ref, 
EDT-87, EDT-165; EVE Ref, EVE-119 to 
EVE-121 

See also Replacing text 

case sensitivity of (EVE) • Text Processing, 1-34 
EDT editor • Text Processing, 2-30 
EVE editor* Text Processing, 1-33 
REPLACE keypad function 
EDT • Text Processing, 2-21 
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Replacing text 

R (replace) ♦ EDT Ref, EDT-302 
REPLACE • EDT Ref, EDT-87, EDT-165 
S (substitute) • EDT Ref, EDT-305 
SEL (select) • EDT Ref, EDT-307 
SN (substitute next) • EDT Ref, EDT-311 
string specifier 

nokeypad mode • EDT Ref, EDT-313 
SUBS • EDT Ref, EDT-100 
SUBSTITUTE • EDT Ref, EDT-243 
SUBSTITUTE NEXT* EDT Ref, EDT-247 
REPLY command • VMS Intro, 1-12; Mail, MAIL-73; 
DCL Dictionary, DCL2-38 to DCL2-46 

See also ANSWER command 

See also INITIALIZE command 

See also MOUNT command 

See also REQUEST command 

/BLANK_TAPE qualifier • Files and Devices, 5-5 

disabling operator status • DCL Dictionary, 

DCL2—40 

enabling operator status • DCL Dictionary, 

DCL2—40 

/INITIALIZEJTAPE qualifier • Files and Devices, 
5-5 

qualifiers • Mail, MAIL-19 
responding to file system requests • DCL 
Dictionary, DCL2-39 

responding to user requests • DCL Dictionary, 
DCL2-39 

fTO qualifier • Files and Devices, 5-4, 5-5 
REQUEST command • DCL Dictionary, DCL2-47 to 
DCL2-48 

.REQUIRE command • DSR Ref, 2-103, 4-8, A-5 
/REQUIRE qualifier • DSR Ref, 5-5, 6-9 
RESEQUENCE command • EDT Ref, EDT-167 
EDT editor • Text Processing, 2-23 
/RESERVE=n qualifier • DSR Ref, 6-9 
RESET command • Using VMS, 8-65; EDT Ref, 
EDT-88; EVE Ref, EVE-122 to EVE-123 

See also Entering commands 
moving text with (EVE) • Text Processing, 1-19 
RESET keypad function 

EDT • Text Processing, 2-18, 2-21 
$RESTART* Using VMS, 5-4; DCL Concepts, 5-2 
Restarting a batch job • Command Procedures, 8—9 
RESTORE BOX SELECTION command • EVE Ref, 
EVE-125 to EVE-126 
EVE editor* Text Processing, 1-22 
RESTORE CHARACTER command • Using VMS, 
8-13; EVE Ref, EVE-127 
EVE editor* Text Processing, 1-16 


RESTORE command • Using VMS, 8-13; EVE Ref, 
EVE-124 

EVE editor* Text Processing, 1-16 
.RESTORE command • DSR Ref, 2-106 
RESTORE LINE command • Using VMS, 8-13; EVE 
Ref, EVE-128 

EVE editor* Text Processing, 1-16 
RESTORE SELECTION command • EVE Ref, 
EVE-129 

EVE editor* Text Processing, 1-16 
moving text with (EVE) • Text Processing, 1—19 
RESTORE SENTENCE command • EVE Ref, 
EVE-130 

RESTORE WORD command • Using VMS, 8-13; 
EVE Ref, EVE-131 
EVE editor* Text Processing, 1-16 
Restoring deleted text 
Ctrl/U • EDT Ref, EDT-47 
LINEFEED • EDT Ref, EDT-59 
UND C • EDT Ref, EDT-52, EDT-56, EDT-106 
UNDC (undelete character) • EDT Ref, EDT-326 
UND L • EDT Ref, EDT-54, EDT-57, EDT-107 
UNDL (undelete line) • EDT Ref, EDT-327 
UND W • EDT Ref, EDT-59, EDT-109 
UNDW (undelete word) • EDT Ref, EDT-329 
Resume execution 

of command procedure • DCL Dictionary, 
DCL1-63 

of DCL commands • DCL Dictionary, DCL1-63 
of program • DCL Dictionary, DCL1-63 
RETURN command • Using VMS, 6-25; DCL 
Dictionary, DCL2-49 to DCL2-50; EDT Ref, 
EDT-42, EDT-90; EVE Ref, EVE-132 
Return key'Using VMS, 1-17, 1-19; DCL 
Concepts, 2-1, 2-8 

pressing to log in • DCL Dictionary, DCL1-392 
using with EVE to format text • Text Processing, 
1-39 

REVERSE command • EVE Ref, EVE-133 

moving the cursor with (EVE) • Text Processing, 
1-9 

/REVERSE_EMPHASIS qualifier • DSR Ref, 4-20 
RIGHT arrow key • DCL Concepts, 2-5 
See also Cursor movement 
keypad mode • EDT Ref, EDT-92 
moving cursor with • Using VMS, 1-18 
moving the cursor with • Text Processing, 1-8 
nokeypad mode • EDT Ref, EDT-304 
.RIGHT command • DSR Ref, 2-104 
.RIGHT MARGIN command • DSR Ref, 2-105 
/RIGHT qualifier • DSR Ref, 4-21 
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Rights list 

modifying • DCL Dictionary, DCL2-212 
RMS (VMS Record Management Services) 
displaying default block count • DCL Dictionary, 
DCL2-318 

RNO file • DSR Ref, 5-1, 5-2 
RNT file • DSR Ref, 5-2 
producing • DSR Ref, 5-3 
with DSR • Text Processing, 3-49 
RNX file • DSR Ref, 6-6 

with DSR • Text Processing, 3-53 
Roman numeral 

chapter number (DSR) • Text Processing, 3-33 
page number (DSR) • Text Processing, 3-34 
Root volume • Files and Devices, 3-8 
RT-11 

volume • Files and Devices, 3-12 

block-addressable • Files and Devices, 5-3, 
5-10 

Ruler key 

See WPS Ruler key 

RUN (Image) command • Using VMS, 3-4; DCL 
Dictionary, DCL2-51 to DCL2-52 
abbreviating • DCL Dictionary, DCL2-51 
and debugger • DCL Dictionary, DCL2-51 
RUN (Process) command • Using VMS, 3-1; DCL 
Dictionary, DCL2-53 to DCL2-62 

See also ATTACH command 
See also SPAWN command 
creating detached process • DCL Dictionary, 
DCL2-61 

Runaway magnetic tape 

stopping • DCL Dictionary, DCL1-241 
RUN command • VMS Intro, 4-3, 4-9, 4-13 
Running DSR 

error messages • DSR Ref, 4-2 
file types • DSR Ref, 4-1 
input • DSR Ref, 4-3 
output • DSR Ref, 4-2, 4-3 
qualifier rules • DSR Ref, 4-3 
qualifiers • DSR Ref, 4-4 
RUNOFF command • DSR Ref, 4-1, 4-2 
Running foot 

layout of • DSR Ref, 2-75 
Running head • Text Processing, 3-37 

adjusting with DSR • Using VMS, 9-13, 9-16 
case of • DSR Ref, 2-65 

date within (DSR) • Text Processing, 3-38; DSR 
Ref, 2-15 

layout of • DSR Ref, 2-75 
specifying title of • DSR Ref, 2-125 


Running head (Cont.) 

subtitles within • DSR Ref, 2-6, 2-120; Text 
Processing, 3-39 

title on first page within (DSR) • Text Processing, 
3-42 

title within (DSR) • Text Processing, 3-37 
turning on and off • DSR Ref, 2-63 
with no chapters • DSR Ref, 2-40 
Runoff 
See DSR 
RUNOFF 

definition of • DSR Ref, 1-1 
examples • DSR Ref, 5-6, 6-9 
qualifiers 

defaults • DSR Ref, 5-3 
list of • DSR Ref, 5-3 

RUNOFF/DEVICE=LN01 [E] • DSR Ref, 4-9, B-1 
RUNOFF/DEVICE=LN03 • DSR Ref, 4-9 
RUNOFF/INDEX command • DSR Ref, 6-6 
RUNOFF command • Using VMS, 9-17; DCL 
Dictionary, DCL2-63 to DCL2-72; Text 
Processing, 3-4, 3-5, 3-6 
RUNOFF/CONTENTS command • DCL Dictionary, 
DCL2-73 to DCL2-76; Text Processing, 3-49 
RUNOFF/INDEX command • DCL Dictionary, 

DCL2-77 to DCL2-80; Text Processing, 3-53 


s 


S (substitute) command • EDT Ref, EDT-305 
See also Replacing text 

SAVE ATTRIBUTES command • EVE Ref, EVE-134 
to EVE-135 

EVE editor* Text Processing, 1-60, 1-61, 1-65, 
1-73 

with command file • EVE Ref, 1-37 
with section file • EVE Ref, 1-36 
.SAVE command • DSR Ref, 2-106 
SAVE command 

See SAVE EXTENDED EVE command 
SAVE EXTENDED EVE command • Using VMS, 
8-39, 8-43; Text Processing, 1-60, 1-61,1-65, 
1-73; EVE Ref, EVE-136 to EVE-137 
using • Text Processing, 1-60 
using to save GOLD key definitions • Text 
Processing, 1-65 

SAVE EXTENDED TPU command • EVE Ref, 
EVE-138 

See also SAVE EXTENDED EVE command 
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SAVE FILE AS command • EVE Ref, EVE-140 
for buffer manipulation (EVE) • Text Processing, 
1-48 

SAVE FILE command • EVE Ref, EVE-139 

for buffer manipulation (EVE) • Text Processing, 
1-48 

/SAVE qualifier • EDT Ref, EDT-7, EDT-169 
with EXIT • EDT Ref, EDT-138 
with QUIT • EDT Ref, EDT-161 
SAVE SYSTEM ATTRIBUTES command • EVE Ref, 
1-38, EVE-141 

EVE editor* Text Processing, 1-72 
Saving attributes • EVE Ref, 1-2 

in a command file (EVE) • Text Processing, 1-77 
in a section file (EVE) • Text Processing, 1-76 
Saving buffer contents to file • EVE Ref, EVE-250 
Scratchpad 

creating (EVE) • Text Processing, 1-50 
Screen layout 

controlling • Phone, PHONE-5 
viewports • Phone, PHONE-2 
Screen-oriented editor* DCL Dictionary, DCL1-180 
EVE • DCL Dictionary, DCL1-189 
VAXTPU • DCL Dictionary, DCL1-189 
Scrolling • VMS Intro, 2-5 
Search 

case-exact • EVE Ref, 1-2 
SEARCH command • VMS Intro, 6-6; Using VMS, 
1-31; Mail, MAIL-3, MAIL-75; DCL Dictionary, 
DCL2-81 to DCL2-87 
Searching for a string • Mail, MAIL-3 
Search list* DCL Dictionary, DCL1-39, DCL1-114 
and the SET DEFAULT command • DCL Concepts, 
4—20 

definition • Using VMS, 4-15; DCL Concepts, 
4-18; Command Procedures, 2-4 
example • Using VMS, 4-15; DCL Concepts, 

4—18 

in a file specification • Using VMS, 4-15; DCL 
Concepts, 4-20 
multiple • DCL Concepts, 4-21 
nested • DCL Concepts, 4-21 
translation • Using VMS, 4-15; Command 
Procedures, 2-4 
Search order 

for logical name translation • Using VMS, 4-11; 
DCL Concepts, 4-11 
Search string • Using VMS, 8-17 

case sensitivity of (EVE) • Text Processing, 1-27 
definition of (EVE) • Text Processing, 1-27 
EDT • Text Processing, 2-29 


Secondary processor 

showing state • DCL Dictionary, DCL2-258 
starting • DCL Dictionary, DCL2-343 
stopping • DCL Dictionary, DCL2-361 
$$Seconds • DSR Ref, 3-18 
SECT command • Using VMS, 8-57; EDT Ref, 
EDT-93 

See also Cursor movement 
Section file • EVE Ref, 1-16 

and initialization file • Using VMS, 8-44 
creating • EVE Ref, EVE-136 
creating (EVE) • Text Processing, 1-76 
default location of • Using VMS, 8-43 
EVE editor* Text Processing, 1-71 
saving attributes in • EVE Ref, 1-35 
saving attributes in (EVE) • Text Processing, 1-71, 
1-73, 1-75 

saving command definitions and learn sequences 
in • Using VMS, 8-43 
Section headers 

format • DSR Ref, 2-22 
levels • DSR Ref, 2-60, 2-111 
numbering sequence of • DSR Ref, 2-89 
specifying format of • DSR Ref, 2-117 
Section number (DSR) • Text Processing, 3-32 
/SECTION qualifier* EVE Ref, 1-16 
/SECTION_NUMBERS qualifier • DSR Ref, 5-5 
+Sect key 

See also SECT command 
on LK201 keyboard • EDT Ref, EDT-93 
-Sect key 

See also SECT command 
on LK201 keyboard • EDT Ref, EDT-93 
SECT keypad function 

EDT • Text Processing, 2-12 
SEL (select) command • EDT Ref, EDT-307 
See also Moving text 
See also Replacing text 
SELECT ALL command • EVE Ref, EVE-145 
moving text with (EVE) • Text Processing, 1-19 
SELECT command* VMS Intro, 1-13; Using VMS, 
1-33, 8-15, 8-62; Mail, MAIL-11, MAIL-76; 
EDT Ref, EDT-95; EVE Ref, EVE-142 to 
EVE-144 

See also Moving text 

for buffer manipulation (EVE) • Text Processing, 
1-48 

moving text with (EVE) • Text Processing, 1-19 
Selecting a box of text 

See also BOX SELECT command 
EVE editor* Text Processing, 1-22 
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Select key 

See also SELECT command 

moving text with (EVE) • Text Processing, 1-18 

on LK201 keyboard • EDT Ref, EDT-95 

to cancel GOLD key (EVE) • Text Processing, 

1-65 

SELECT keypad function 

EDT • Text Processing, 2-18, 2-20 
/SELF qualifier • Mail, MAIL-22 
SEND command* VMS Intro, 1-11; Using VMS, 
1-28; Mail, MAIL-5, MAIL-79 
See also MAIL command 
qualifiers • Mail, MAIL-19 
SEND/EDIT command (MAIL) • Using VMS, 1-35 
Sending files • Mail, MAIL-4, MAIL-6 
Sending messages • Mail, MAIL-4, MAIL-5, MAIL-57 
canceling ♦ Mail, MAIL-5 
over the network • Mail, MAIL-1, MAIL-6 
to distribution lists • Mail, MAIL-6 
using DECnet-VAX • Mail, MAIL-7 
.SEND TOC command • DSR Ref, 2-107, 4-8 
example • DSR Ref, 2-107 
/SEPARATEJJNDERLINE qualifier • DSR Ref, 4-22 
Sequence checking 

default •Sort/Merge, SORT-12 
specifying • Sort/Merge, SORT-51 
/SEQUENCE qualifier • EDT Ref, EDT-170; DSR 
Ref, 4-23 

EDT editor • Text Processing, 2-23 
with EXIT • EDT Ref, EDT-138 
with RESEQUENCE • EDT Ref, EDT-167 
with WRITE • EDT Ref, EDT-253 
Sequential file • Using VMS, 2-4 

and Sort/Merge Utility • Using VMS, 1-41 
/SEQUENTIAL qualifier • Sort/Merge, SORT-48 
Server queue • DCL Dictionary, DCL1-251 
SET ACCOUNTING command • DCL Dictionary, 
DCL2-91 to DCL2-92 
See also ACCOUNTING command 
SET ACL command • Using VMS, 7-13, 7-14; Files 
and Devices, 4-9; DCL Concepts, 4-18; DCL 
Dictionary, DCL2-93 to DCL2-99 
SET AUDIT command* DCL Dictionary, DCL2-100 
to DCL2-111 

SET AUTOREPEAT command • EDT Ref, EDT-171 
See also Terminal attributes 
SET AUTO_PURGE command • Mail, MAIL-83 
SET BOX NOPAD command • EVE Ref, EVE-146 
EVE editor* Text Processing, 1-22 
SET BOX NOSELECT command • EVE Ref, 
EVE-147 


SET BOX NOSELECT command (Cont.) 

EVE editor* Text Processing, 1-22 
SET BOX PAD command • EVE Ref, EVE-148 
EVE editor* Text Processing, 1-22 
SET BOX SELECT command • EVE Ref, EVE-149 
EVE editor* Text Processing, 1-22 
SET BROADCAST command ♦ DCL Dictionary, 
DCL2-112 to DCL2-113 
SET BUFFER command • EVE Ref, EVE-150 to 
EVE-151 

changing editing status with (EVE) • Text 
Processing, 1-50 

creating a scratchpad with (EVE) • Text 
Processing, 1-50 

for buffer manipulation (EVE) • Text Processing, 
1-48 

keywords with (EVE) • Text Processing, 1-50 
SET CARD_READER command • DCL Dictionary, 
DCL2-114 

SET CASE command • EDT Ref, EDT-172 
SET CASE LOWER command • EDT Ref, EDT-172 
SET CASE NONE command • EDT Ref, EDT-172 
SET CASE UPPER command • EDT Ref, EDT-172 
SET CC_PROMPT command • Mail, MAIL-84 
SET CLIPBOARD command • EVE Ref, EVE-152 
SET CLUSTER/EXPECTED_VOTES command • 
DCL Dictionary, DCL2-115 to DCL2-116 
SET command • DCL Dictionary, DCL2-88 to 
DCL2-90 

summary of options • DCL Dictionary, DCL2-88 
SET COMMAND command • DCL Dictionary, 
DCL2-117; EDT Ref, EDT-173 
SET commands 

line mode • EDT Ref, EDT-171 
SET CONTROL=Y command • Using VMS, 6-32 
SET CONTROL command • DCL Dictionary, 
DCL2-118 to DCL2-119 
SET CONTROL_Y command • Command 
Procedures, 7-10 

SET COPY_SELF command • Mail, MAIL-86 
SET CURSOR BOUND command • Using VMS, 8-9; 
EVE Ref, EVE-153 to EVE-154 
moving the cursor with (EVE) • Text Processing, 
1-10 

SET CURSOR command • EDT Ref, EDT-175 
See also Cursor movement 
SET CURSOR FREE command • Using VMS, 8-9; 
EVE Ref, EVE-155 

moving the cursor with (EVE) • Text Processing, 
1-10 

.SET DATE command • DSR Ref, 2-109, A-5 
SET DAY command • DCL Dictionary, DCL2-120 
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SET DEFAULT command • VMS Intro, 3-8; Using 
VMS, 2-22, 2-23; DCL Concepts, 3-12; DCL 
Dictionary, DCL2-121 to DCL2-122 
and a logical name search list • DCL Concepts, 
4-20 

SET DEFAULT COMMAND FILE command • EVE 
Ref, 1-38, EVE-156 
EVE editor • Text Processing, 1-73 
SET DEFAULT SECTION FILE command • EVE Ref, 
1-36, EVE-157 to EVE-158 
EVE editor* Text Processing, 1-73 
SET DEVICE command • DCL Dictionary, DCL2-123 
to DCL2-124 

SET DEVICE/SERVED command • DCL Dictionary, 
DCL2-125 

SET DIRECTORY command • Files and Devices, 

4-9; DCL Concepts, 3-12; DCL Dictionary, 
DCL2-126 to DCL2-128 
SET DISPLAY command • DCL Dictionary, 

DCL2-129 to DCL2-135 

SET EDITOR command • Using VMS, 1-35; Mail, 
MAIL-85 

SET EDITOR TPU command in MAIL • EVE Ref, 
1-24 

SET ENTITY command • Using VMS, 8-72; EDT 
Ref, EDT-176 

SET ENTITY PAGE command • EDT Ref, EDT-176 
SET ENTITY PARAGRAPH command • EDT Ref, 
EDT-176 

SET ENTITY SENTENCE command • EDT Ref, 
EDT-176 

SET ENTITY WORD command • EDT Ref, EDT-176 
SET ENTRY command • Command Procedures, 8-7; 

DCL Dictionary, DCL2-136 to DCL2-143 
SET EXIT ATTRIBUTE CHECK command • EVE Ref, 
EVE-159 

EVE editor • Text Processing, 1-73 
SET FILE/PROTECTION command • VMS Intro, 2-8 
SET FILE command • Files and Devices, 4-9, 4-10; 
Mail, MAIL-87; DCL Dictionary, DCL2-144 to 
DCL2-148 

SET FIND CASE EXACT command • EVE Ref, 
EVE-160 

finding text with (EVE) • Text Processing, 1-26 
SET FIND CASE NOEXACT command • EVE Ref, 
EVE-161 

finding text with (EVE) • Text Processing, 1-26 
SET FIND command • Using VMS, 8-19 
SET FIND NOWHITESPACE command • EVE Ref, 
EVE-162 

EVE editor* Text Processing, 1-26, 1-30 
SET FIND WHITESPACE command • EVE Ref, 
EVE-163 


SET FIND WHITESPACE command (Cont.) 

EVE editor* Text Processing, 1-26, 1-30 
SET FNF command • EDT Ref, EDT-178 
SET FOLDER command • Mail, MAIL-88 
SET FORM command • Mail, MAIL-91 
SET FORWARD command • Mail, MAIL-92 
SET FUNCTION KEYS DECWINDOWS command • 
EVE Ref, 1-27, EVE-164 
SET FUNCTION KEYS NODECWINDOWS 
command • EVE Ref, EVE-165 
SET GOLD KEY command • Using VMS, 8-41; EVE 
Ref, EVE-166 to EVE-167 

EVE editor* Text Processing, 1-59, 1-62 
SET HELP command* EDT Ref, EDT-179 
SET HOST command • Using VMS, 1-3; DCL 
Dictionary, DCL2-149 to DCL2-151 

See also Network node 
SET HOST/DTE command • DCL Dictionary, 

DCL2-152 

DTE commands* DCL Dictionary, DCL2-158 
CLEAR • DCL Dictionary, DCL2-158 
EXIT* DCL Dictionary, DCL2-159 
QUIT* DCL Dictionary, DCL2-160 
SAVE • DCL Dictionary, DCL2-161 
SEND BREAK • DCL Dictionary, DCL2-162 
SET DTE • DCL Dictionary, DCL2-163 
SHOW DTE • DCL Dictionary, DCL2-168 
SPAWN • DCL Dictionary, DCL2-169 
SET HOST/DUP command • DCL Dictionary, 
DCL2-171 to DCL2-172 

See also Network node 
SET HOST/HSC command • DCL Dictionary, 
DCL2-173 to DCL2-174 

See also Network node 

SET JOURNALING ALL command • EVE Ref, 1-23, 
EVE-169 

EVE editor* Text Processing, 1-37 
SET JOURNALING command • EVE Ref, 1-23, 
EVE-168 

EVE editor* Text Processing, 1-37 
SET KEY command • DCL Dictionary, DCL2-175 
SET KEYPAD command • EDT Ref, EDT-180 

EDT editor • Text Processing, 2-32 
SET KEYPAD EDT command/BEGIN • EVE Ref, 
EVE-170 

SET KEYPAD EDT command/END • EVE Ref, 
EVE-176 

SET KEYPAD NOEDT command • EVE Ref, 
EVE-177 

SET KEYPAD NOWPS command • EVE Ref, 
EVE-178 
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SET KEYPAD NUMERIC command • EVE Ref, 
EVE-179 to EVE-180 

SET KEYPAD VT100 command • EVE Ref, EVE-181 
to EVE-182 

SET KEYPAD WPS command/BEGIN • EVE Ref, 
EVE-183 

SET KEYPAD WPS command/END • EVE Ref, 
EVE-190 

SET LEFT MARGIN command • Using VMS, 8-26, 
8-36; EVE Ref, EVE-191 to EVE-192 
formatting text with (EVE) • Text Processing, 1-40 
.SET LEVEL command • DSR Ref, 2-111 
example • DSR Ref, 2-111 

SET LINES command • Using VMS, 8-72; EDT Ref, 
EDT-181 

See also Displaying text 
EDT editor • Text Processing, 2-32, 2-53 
SET LOGINS command • DCL Dictionary, DCL2-176 
SET MAGTAPE command • Files and Devices, 4-9, 
4-10; DCL Dictionary, DCL2-177 to DCL2-178 
SET MAIL_DIRECTORY command • Mail, MAIL-94 
SET MESSAGE command • Using VMS, 1-20; DCL 
Dictionary, DCL2-179 to DCL2-181 
SET MODE CHANGE command • EDT Ref, EDT-183 
SET MODE command • Using VMS, 8-73; EDT Ref, 
EDT-183 

EDT editor • Text Processing, 2-32, 2-53 
SET MODE LINE command • EDT Ref, EDT-183 
SET NOAUTOREPEAT command • EDT Ref, 
EDT-171 

SET NOAUTO_PURGE command • Mail, MAIL-83 
SET NOCC_PROMPT command • Mail, MAIL-84 
SET NOCLIPBOARD command • EVE Ref, EVE-193 
SET NOCOPY_SELF command • Mail, MAIL-86 
SET NODEFAULT COMMAND FILE command • EVE 
Ref, EVE-194 

EVE editor* Text Processing, 1-73 
SET NODEFAULT SECTION FILE command • EVE 
Ref, 1-36, EVE-195 
EVE editor* Text Processing, 1-73 
SET NOEXIT ATTRIBUTE CHECK command • EVE 
Ref, 1-35, EVE-196 
EVE editor* Text Processing, 1-73 
SET NOFNF command • EDT Ref, EDT-178 
SET NOFORM command • Mail, MAIL-91 
SET NOFORWARD command • Mail, MAIL-92 
SET NOGOLD KEY command • Using VMS, 8-43; 
EVE Ref, EVE-197 

EVE editor* Text Processing, 1-59, 1-65 
SET NOJOURNALING ALL command • EVE Ref, 
1-22, EVE-199 

EVE editor* Text Processing, 1-37 


SET NOJOURNALING command • EVE Ref, 1-22, 
EVE-198 

EVE editor* Text Processing, 1-37 
SET NOKEYPAD command • EDT Ref, EDT-180 
SET NOMAIL_DIRECTORY command • Mail, 
MAIL-94 

SET NONUMBERS command • EDT Ref, EDT-184 
EDT editor • Text Processing, 2-52 
SET NOON command • Command Procedures, 7-5 
SET NOPENDING DELETE command • EVE Ref, 
EVE-200 

EVE editor* Text Processing, 1-19 
SET NOPERSONAL_NAME command • Mail, 
MAIL-95 

SET NOQUEUE command • Mail, MAIL-97 
SET NOQUIET command • EDT Ref, EDT-188 
SET NOREPEAT command • EDT Ref, EDT-189 
SET NOSECTION FILE PROMPTING command* 
EVE Ref, 1-36, 1-38, EVE-201 
EVE editor* Text Processing, 1-73 
SET NOSHIFT KEY command 
EVE editor* Text Processing, 1-59 
SET NOSUMMARY command • EDT Ref, EDT-195 
SET NOTAB command • EDT Ref, EDT-196 
SET NOTRUNCATE command • EDT Ref, EDT-201 
SET NOVERIFY command • EDT Ref, EDT-202 
SET NOWRAP command • Using VMS, 8-36; EDT 
Ref, EDT-204 

formatting text with (EVE) • Text Processing, 1-41 
SET NOWRAP command/BEGIN • EVE Ref, 
EVE-202 

SET NOWRAP command/END • EVE Ref, EVE-202 
SET NUMBERS command • Using VMS, 8-62; EDT 
Ref, EDT-184 

See also Displaying text 
EDT editor • Text Processing, 2-32 
SET ON command • Using VMS, 6-30, 6-31; DCL 
Dictionary, DCL2-182 

SET OUTPUT_RATE command • DCL Dictionary, 
DCL2-183 

SET PARAGRAPH command • EDT Ref, EDT-185 
See also Cursor positioning 
.SET PARAGRAPH command • DSR Ref, 2-114 
SET PARAGRAPH INDENT command • EVE Ref, 
EVE-203 to EVE-204 
EVE editor* Text Processing, 1-44 
formatting text with (EVE) • Text Processing, 1-40 
with filling a range • EVE Ref, EVE-59, EVE-62 
SET PARAGRAPH NOWPS command • EDT Ref, 
EDT-185 

SET PARAGRAPH WPS command • EDT Ref, 

EDT-185 
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SET PARAGRAPH WPS command (Cont.) 

See also Cursor positioning 
SET PASSWORD command • VMS Intro, 1-3; 

Using VMS, 1-2; DCL Dictionary, DCL2-184 to 
DCL2-186 

SET PENDING DELETE command • EVE Ref, 
EVE-205 

EVE editor* Text Processing, 1-19 
SET PERSONAL.NAME command • Mail, MAIL-95 
SET PRINTER command • DCL Dictionary, 

DCL2-187 to DCL2-190 

SET PROCESS command • VMS Intro, 6-11; DCL 
Dictionary, DCL2-191 to DCL2-194 
SET PROMPT command • VMS Intro, 6-10; DCL 
Dictionary, DCL2-195; EDT Ref, EDT-186 

See also Terminal attributes 
SET PROTECTION command • VMS Intro, 3-7; 
Using VMS, 7-10; Files and Devices, 4-9, 
4-11; DCL Concepts, 8-6, 8-8, 8-9; DCL 
Dictionary, DCL2-196 to DCL2-198 
/DEFAULT qualifier • Files and Devices, 2-10 
SET PROTECTION/DEFAULT command • DCL 
Concepts, 8-9; DCL Dictionary, DCL2-199 
SET PROTECTION/DEVICE command • Using VMS, 

7- 3; DCL Dictionary, DCL2-200 to DCL2-202 
SET QUEUE command • Mail, MAIL-97; DCL 

Concepts, 8-7; DCL Dictionary, DCL2-203 to 
DCL2-209 

SET QUEUE/ENTRY command • Command 
Procedures, 8-7 

SET QUIET command • Using VMS, 8-73; EDT Ref, 
EDT-188 

See also Terminal attributes 
EDT editor • Text Processing, 2-32, 2-52 
SET REPEAT command • EDT Ref, EDT-189 
See also Terminal attributes 
SET RESTART_VALUE command • DCL Dictionary, 
DCL2-210 to DCL2-211 

SET RIGHT MARGIN command • Using VMS, 8-27, 

8- 36; EVE Ref, EVE-206 

EVE editor* Text Processing, 1-42 
formatting text with (EVE) • Text Processing, 1-40 
SET RIGHTSJJST command • DCL Dictionary, 
DCL2-212 to DCL2-213 
SET RMS_DEFAULT command • DCL Dictionary, 
DCL2-214 to DCL2-217 

SET SCREEN command • Using VMS, 8-72; EDT 
Ref, EDT-190 
See also Displaying text 
SET SCROLL MARGINS command • EVE Ref, 
EVE-207 to EVE-208 

using with EVE to move cursor • Text Processing, 
1-10 


SET SEARCH BEGIN command • EDT Ref, EDT-192 
SET SEARCH BOUNDED command • EDT Ref, 
EDT-192 

SET SEARCH CASE INSENSITIVE command • EDT 
Ref, EDT-192 

SET SEARCH command • Using VMS, 8-63, 8-65; 
EDT Ref, EDT-192 
See also Locating text 
SET SEARCH DIACRITICAL INSENSITIVE 
command • EDT Ref, EDT-192 
SET SEARCH END command • EDT Ref, EDT-192 
SET SEARCH EXACT command • EDT Ref, 
EDT-192 

EDT editor* Text Processing, 2-17, 2-32, 2-53 
SET SEARCH GENERAL command • EDT Ref, 
EDT-192 

SET SEARCH UNBOUNDED command • EDT Ref, 
EDT-192 

SET SEARCH WPS command • EDT Ref, EDT-192 
SET SECTION FILE PROMPTING command • EVE 
Ref, 1-36, EVE-209 
EVE editor* Text Processing, 1-73 
SET SHIFT KEY command 

EVE editor* Text Processing, 1-59 
SET SUMMARY command • EDT Ref, EDT-195 
See also Terminal attributes 
SET SYMBOL command • Using VMS, 5-5; 

Command Procedures, 2-8; DCL Dictionary, 
DCL2-218 to DCL2-220 

SET SYMBOL/SCOPE command • Using VMS, 5-5; 
DCL Concepts, 5-4 

SET TAB command • EDT Ref, EDT-196 
See also Tabbing functions 
EDT editor* Text Processing, 2-38 
SET TABS AT command 

formatting text with (EVE) • Text Processing, 1-40 
SET TABS command • Using VMS, 8-36; EVE Ref, 
EVE-210 to EVE-212 
SET TABS EVERY command 

formatting text with (EVE) • Text Processing, 1-40 
SET TABS INSERT command 

formatting text with (EVE) • Text Processing, 1-40 
SET TABS INVISIBLE command 

formatting text with (EVE) • Text Processing, 1-41 
SET TABS MOVEMENT command 

formatting text with (EVE) • Text Processing, 1-41 
SET TABS SPACES command 

formatting text with (EVE) • Text Processing, 1-41 
SET TABS VISIBLE command 

formatting text with (EVE) • Text Processing, 1-41 
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SET TERMINAL command • VMS Intro, 6-14; Using 
VMS, 1-23, 3-6; DCL Concepts, 2-4; DCL 
Dictionary, DCL2-221 to DCL2-233 

See also SHOW TERMINAL command 
/APPLICATION_KEYPAD qualifier* VMS Intro, 
6-15 

/ECHO qualifier* VMS Intro, 6-14 
/INSERT qualifier • VMS Intro, 6-15 
/NOECHO qualifier • VMS Intro, 6-14 
/NOWRAP command • VMS Intro, 6-16 
/NUMERIC.KEYPAD qualifier* VMS Intro, 6-15 
/OVERSTRIKE qualifier* VMS Intro, 6-15 
/WIDTH qualifier* VMS Intro, 6-16 
/WRAP command • VMS Intro, 6-16 

SET TERMINAL EDIT command • EDTRef, EDT-198 
See also Terminal attributes command 

SET TERMINAL EIGHTBIT command • EDT Ref, 
EDT-198 

SET TERMINAL HCPY command • EDT Ref, 
EDT-198 

SET TERMINAL NOEDIT command • EDT Ref, 
EDT-198 

SET TERMINAL NOEIGHTBIT command • EDTRef, 
EDT-198 

SET TERMINAL NOSCROLL command • EDT Ref, 
EDT-198 

SET TERMINAL SCROLL command • EDT Ref, 
EDT-198 

SET TERMINAL VT100 command • EDT Ref, 
EDT-198 

SET TERMINAL VT52 command • EDT Ref, 

EDT-198 

SET TEXT END command • EDTRef, EDT-200 

SET TEXT PAGE command ♦ EDT Ref, EDT-200 

SET TIME command • DCL Dictionary, DCL2-234 to 
DCL2-235 

.SET TIME command • DSR Ref, 2-109, A-5 

Setting 

date • DSR Ref, 2-109 
time • DSR Ref, 2-109 

SET TRUNCATE command • Using VMS, 8-72; 
EDTRef, EDT-201 
See also Displaying text 
See also Formatting, text 

SET UIC command • Using VMS, 7-3; DCL 
Dictionary, DCL2-236 

See also Protection 

SET VERIFY command • Using VMS, 6-28; DCL 
Dictionary, DCL2-237 to DCL2-239; EDTRef, 
EDT-202 

changing with F$VERIFY lexical function • 
Command Procedures, 3-13 


SET VERIFY command (Cont.) 

debugging command procedure with • Command 
Procedures, 1-13 

SET VOLUME command • Files and Devices, 4-9; 
DCL Concepts, 8-7; DCL Dictionary, DCL2-240 
to DCL2-243 

SET WASTEBASKET_NAME command • Mail, 
MAIL-98 

SET WIDTH command • Using VMS, 8-28, 8-36; 
EVE Ref, EVE-213 to EVE-214 
in window environment (EVE) • Text Processing, 
1-56 

SET WILDCARD ULTRIX command • EVE Ref, 
EVE-215 

EVE editor* Text Processing, 1-26 
SET WILDCARD VMS command • EVE Ref, 
EVE-216 

EVE editor* Text Processing, 1-26 
SET WORD DELIMITER command • EDT Ref, 
EDT-203 

See also Cursor movement 
SET WORD NODELIMITER command • EDT Ref, 
EDT-203 

SET WORKING_SET command • DCL Dictionary, 
DCL2-244 to DCL2-245 
SET WRAP command • Using VMS, 8-36, 8-67, 
8-72; EDTRef, EDT-204; EVE Ref, EVE-217 
See also Formatting, text 
EDT editor • Text Processing, 2-53 
formatting text with (EVE) • Text Processing, 1-41 
SSEVERITY • DCL Concepts, 5-2; DCL Dictionary, 
DCL2-182 

changing • DCL Dictionary, DCL1-222, DCL2-49 
$SEVERITY global symbol 

commands that do not set • Command 
Procedures, 7-2 

definition • Command Procedures, 7-2 
testing for successful (odd) value • Command 
Procedures, 7-2 

value with SET NOON • Command Procedures, 
7-5 

Severity level 

determining • Command Procedures, 7-2 
specifying error handling based upon • Command 
Procedures, 7-4 

testing for with IF command • Command 
Procedures, 7-2 

use of ON command with • Command Procedures, 
7-2 

SSEVERITY symbol • Using VMS, 5-4 
Shareable files 

opening • Command Procedures, 6-3 
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Shareable image 

file analysis* DCL Dictionary, DCL1-22 
patching • DCL Dictionary, DCL2-11 
Shareable image file 

analyzing • DCL Dictionary, DCL1-22 
creating • DCL Dictionary, DCL1-388 
Shareable tables 

definition • DCL Concepts, 4-6 
group logical name table • Using VMS, 4-7; DCL 
Concepts, 4-6 

job logical name • DCL Concepts, 4-6 
system logical name table • Using VMS, 4-7; 

DCL Concepts, 4-7 
user-defined • DCL Concepts, 4-15 
Shareable volume 

dismounting • DCL Dictionary, DCL1-170 
initializing disk as • DCL Dictionary, DCL1-247 
Shared device 

dismounting • DCL Dictionary, DCL1-171 
SHIFT LEFT command • Using VMS, 8-28, 8-36; 
EVE Ref, EVE-218 

in window environment (EVE) • Text Processing, 
1-56 

moving the cursor with (EVE) • Text Processing, 
1-10 

SHIFT RIGHT command • Using VMS, 8-28, 8-36; 
EVE Ref, EVE-219 

in window environment (EVE) • Text Processing, 
1-56 

moving the cursor with (EVE) • Text Processing, 
1-10 

SHL (shift left) command • EDT Ref, EDT-309 
See also Displaying text 

SHOW ACCOUNTING command • DCL Dictionary, 
DCL2-248 to DCL2-249 
See also ACCOUNTING command 
items enabled • DCL Dictionary, DCL2-248 
SHOW ACL command • Using VMS, 7-12; Files and 
Devices, 2-13, 4-2; DCL Dictionary, DCL2-250 
SHOW ALL command • Mail, MAIL-99 
SHOW AUDIT command • DCL Dictionary, 

DCL2-251 to DCL2-254 
SHOW AUTOREPEAT command • EDT Ref, 

EDT-206 

See also Terminal attributes 
SHOW AUTO_PURGE command • Mail, MAIL-83 
SHOW BROADCAST command • DCL Dictionary, 
DCL2-255 to DCL2-256 

SHOW BUFFER command • Using VMS, 8-70; EDT 
Ref, EDT-207 

EDT editor • Text Processing, 2-34 


SHOW BUFFERS command • Using VMS, 8-31, 
8-32; EVE Ref, EVE-222 
EVE editor* Text Processing, 1-51 
for buffer manipulation (EVE) • Text Processing, 
1-48 

SHOW CASE command • EDT Ref, EDT-208 
SHOW CC_PROMPT command • Mail, MAIL-84 
SHOW CLUSTER command • DCL Dictionary, 
DCL2-257 

SHOW command • VMS Intro, 1-3; Using VMS, 
8-31; Files and Devices, 4-1; DCL Dictionary, 
DCL2-246 to DCL2-247; EVE Ref, EVE-220 
to EVE-221 

EVE editor* Text Processing, 1-49 
for buffer manipulation (EVE) • Text Processing, 
1-48 

summary of options • DCL Dictionary, DCL2-246 
SHOW COMMAND command • EDT Ref, EDT-209 
SHOW commands 

line mode • EDT Ref, EDT-206 
SHOW COPY_SELF command • Mail, MAIL-86 
SHOW CPU command • DCL Dictionary, DCL2-258 
to DCL2—261 

SHOW CURSOR command • EDT Ref, EDT-210 
See also Cursor positioning 
SHOW DEFAULT command • VMS Intro, 3-6; 

Using VMS, 2-22; DCL Concepts, 3-12; DCL 
Dictionary, DCL2-262 to DCL2-263 
SHOW DEFAULTS BUFFER command • EVE Ref, 
EVE-223 to EVE-224 

for buffer manipulation (EVE) • Text Processing, 
1—49 

SHOW DELETED command • Mail, MAIL-101 
SHOW DEVICES command* VMS Intro, 3-5; 

Using VMS, 7-12; Files and Devices, 2-13, 
3-16,4-2,4-4; DCL Dictionary, DCL2-264 to 
DCL2-268 

SHOW DEVICES/SERVED command • DCL 
Dictionary, DCL2-269 to DCL2-271 
SHOW DISPLAY command • DCL Dictionary, 
DCL2-272 to DCL2-274 
See also SET DISPLAY command 
SHOW EDITOR command • Mail, MAIL-85 
SHOW ENTITY command • EDT Ref, EDT-211 
SHOW ENTITY PAGE command • EDT Ref, 
EDT-211 

SHOW ENTITY PARAGRAPH command • EDT Ref, 
EDT-211 

SHOW ENTITY SENTENCE command • EDT Ref, 
EDT-211 

SHOW ENTITY WORD command • EDT Ref, 
EDT-211 
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SHOW ENTRY command • Using VMS, 2-18, 3-8; 
Command Procedures, 8-6; DCL Dictionary, 
DCL2-275 to DCL2-278 
SHOW ERROR command • DCL Dictionary, 
DCL2-279 

SHOW FILE command • Mail, MAIL-87 
SHOW FILES command • EDT Ref, EDT-212 
SHOW FNF command • EDT Ref, EDT-213 
SHOW FOLDER command • Mail, MAIL-88 
SHOW FORM command • Mail, MAIL-91 
SHOW FORWARD command • Mail, MAIL-92 
SHOW HELP command • EDT Ref, EDT-214 
SHOW INTRUSION command • DCL Dictionary, 
DCL2-280 to DCL2-282 
SHOW KEY command • VMS Intro, 6-11; Using 
VMS, 1-26; Mail, MAIL-102; DCL Dictionary, 
DCL2-283 to DCL2-284; EDT Ref, EDT-215; 
EVE Ref, EVE-225 

SHOW KEYPAD command • EDT Ref, EDT-218 
SHOW LICENSE command • DCL Dictionary, 
DCL2-285 

SHOW LINES command • EDT Ref, EDT-219 
See also Displaying text 
EDT editor • Text Processing, 2-33 
SHOW LOGICAL command • VMS Intro, 3-10; 

Using VMS, 4-4; Command Procedures, 2-4; 
DCL Dictionary, DCL2-288 to DCL2-291 

See also SHOW TRANSLATION command 
and logical name access mode • Using VMS, 4-13 
and logical name table structure • Using VMS, 4-9 
default search order • DCL Concepts, 4-3 
displaying all logical name tables • DCL Concepts, 
4—3 

displaying a particular logical name table • DCL 
Concepts, 4-4 

displaying the access mode of a logical name • 
DCL Concepts, 4-14 

displaying the logical name table structure • DCL 
Concepts, 4-8 

including a wildcard • DCL Concepts, 4-4 
SHOW MAGTAPE command • Files and Devices, 
4-2, 4-6 

SHOW MAIL_DIRECTORY command • Mail, 

MAIL-94 

SHOW MEMORY command • DCL Dictionary, 
DCL2-292 to DCL2-299 
SHOW MODE command • EDT Ref, EDT-220 
SHOW NEW_MAIL_COUNT command • Mail, 
MAIL-103 

SHOW NUMBERS command • EDT Ref, EDT-221 
EDT editor • Text Processing, 2-33 
SHOW PARAGRAPH command • EDT Ref, EDT-222 


SHOW PERSONAL_NAME command • Mail, 

MAIL-95 

SHOW PRINTER command • DCL Dictionary, 
DCL2-300 to DCL2-301 
SHOW PROCESS command • VMS Intro, 6-11; 
Using VMS, 3-2, 7-12; Files and Devices, 
2-13; DCL Dictionary, DCL2-302 to DCL2-307 
SHOW PROMPT command • EDT Ref, EDT-223 
See also Terminal attributes 
SHOW PROTECTION command • Using VMS, 7-12; 
Files and Devices, 2-13, 4-2, 4-7, 4-8; DCL 
Concepts, 8-9; DCL Dictionary, DCL2-308 
SHOW QUEUE/CHARACTERISTICS command* 
DCL Dictionary, DCL2-313 to DCL2-314 
SHOW QUEUE command • Using VMS, 2-18; Mail, 
MAIL-97; Command Procedures, 8-6; DCL 
Dictionary, DCL2-309 to DCL2-312 
with a batch queue • VMS Intro, 6-3 
with a print queue • VMS Intro, 6-2 
SHOW QUEUE/FORM command • DCL Dictionary, 
DCL2-315 to DCL2-316 
SHOW QUIET command • EDT Ref, EDT-224 
See also Terminal attributes 
SHOW QUOTA command • Files and Devices, 4-2, 
4-8; DCL Dictionary, DCL2-317 
SHOW REPEAT command • EDT Ref, EDT-225 
See also Terminal attributes 
SHOW RMS_DEFAULT command • DCL Dictionary, 
DCL2-318 

SHOW SCREEN command • EDT Ref, EDT-226 
SHOW SEARCH command • EDT Ref, EDT-227 
See also Locating text 
EDT editor • Text Processing, 2-33 
SHOW STATUS command • DCL Dictionary, 

DCL2-319 

SHOW SUMMARY command • EDT Ref, EDT-229; 
EVE Ref, EVE-226 
See also Processing commands 
SHOW SYMBOL command • VMS Intro, 5-2; Using 
VMS, 5-5, 6-29; DCL Concepts, 5-4; DCL 
Dictionary, DCL2-320 to DCL2-321 
SHOW SYSTEM BUFFERS command • Using VMS, 
8-31; EVE Ref, EVE-227 
EVE editor* Text Processing, 1-51 
for buffer manipulation (EVE) • Text Processing, 
1-49 

SHOW SYSTEM command • DCL Dictionary, 
DCL2-322 to DCL2-325 
SHOW TAB command • EDT Ref, EDT-230 
See also Tabbing functions 
EDT editor • Text Processing, 2-43 
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SHOW TERMINAL command* VMS Intro, 6-13; 

DCL Concepts, 2-4; DCL Dictionary, DCL2-326 
to DCL2-327; EDT Ref, EDT-232 
See also SET TERMINAL command 
See also Terminal attributes 
SHOW TEXT command • EDT Ref, EDT-233 
SHOW TEXT END command • EDT Ref, EDT-233 
SHOW TEXT PAGE command • EDT Ref, EDT-233 
SHOW TIME command • VMS Intro, 1-3; DCL 
Dictionary, DCL2-328 

SHOW TRANSLATION command • Using VMS, 4-4; 
DCL Concepts, 4-3; DCL Dictionary, DCL2-329 
to DCL2-330 

See also SHOW LOGICAL command 
SHOW TRUNCATE command • EDT Ref, EDT-234 
See also Displaying text 
SHOW USERS command • DCL Dictionary, 
DCL2-331 to DCL2-334 
SHOW VERIFY command • EDT Ref, EDT-235 
See also Processing text 
SHOW VERSION command • EDT Ref, EDT-236 
SHOW WASTEBASKET_NAME command • Mail, 
MAIL-98 

SHOW WILDCARDS command • EVE Ref, EVE-228 
EVE editor* Text Processing, 1-26 
SHOW WORD command • EDT Ref, EDT-238 
SHOW WORKING_SET command • DCL Dictionary, 
DCL2-335 

SHOW WRAP command • EDT Ref, EDT-239 
See also Displaying text 

SHOW ZONE command • DCL Dictionary, DCL2-336 
SHR (shift right) command • EDT Ref, EDT-310 
See also Displaying text 

SHRINK WINDOW command • Using VMS, 8-35; 
EVE Ref, EVE-229 

in window environment (EVE) • Text Processing, 
1-56 

Sign (+1 -) specifier 

with APPEND • EDT Ref, EDT-261 
with CHGC (change case) • EDT Ref, EDT-266 
with CHGL (change case lower) • EDT Ref, 
EDT-267 

with CHGU (change case upper) • EDT Ref, 
EDT-268 

with CUT • EDT Ref, EDT-275 

with D (delete) • EDT Ref, EDT-276 

with FILL • EDT Ref, EDT-289 

with “move” • EDT Ref, EDT-296 

with R (replace) • EDT Ref, EDT-302 

with S (substitute) • EDT Ref, EDT-305 

with SN (substitute next) • EDT Ref, EDT-311 


Sign (+1 -) specifier (Cont.) 

with SSEL (search and select) • EDT Ref, 
EDT-312 

with TADJ (tab adjust) • EDT Ref, EDT-317 
/SIMULATE qualifier • DSR Ref, 4-24 
Single-file/multivolume configuration • Files and 
Devices, B-5 

Single-file/single-volume configuration • Files and 
Devices, B-4 

.SKIP command • DSR Ref, 2-115 
SN (substitute next) command • EDT Ref, EDT-311 
See also Replacing text 
Soft page break 

See PAGINATE command 
Sort 

batch job • Using VMS, 1-41 
character data • Using VMS, 1-39 
collating sequence* Using VMS, 1-39 
indexed output file • Using VMS, 1-41 
key • Using VMS, 1-38 
output file • Using VMS, 1-41 
single key • Using VMS, 1-38 
terminal input* Using VMS, 1-40 
types of* Using VMS, 1-37 to 1-39 
SORT 

See Sort/Merge Utility 

SORT command • VMS Intro, 6-4; Using VMS, 
1-37, 1-38; DCL Dictionary, DCL2-337 

See also Sort/Merge Utility 
Sorting process • Sort/Merge, SORT-3 
address • Sort/Merge, SORT-29 
default • Sort/Merge, SORT-29, SORT-70 
index • Sort/Merge, SORT-29 
record • Sort/Merge, SORT-29 
selecting • Sort/Merge, SORT-29 
specifying • Sort/Merge, SORT-70 
tag • Sort/Merge, SORT-29 
Sort/Merge Utility (SORT) 

See also Sort 

collating sequence • Sort/Merge, SORT-4 
collating sequences 

ASCII • Using VMS, 1-39 
EBCDIC • Using VMS, 1-39 
DCL qualifiers • Sort/Merge, SORT-11 to 
SORT-35 

directing output from • Sort/Merge, SORT-10 
entering records from terminal with • Using VMS, 
1-40 

example • Sort/Merge, SORT-1 
exiting • Sort/Merge, SORT-10 
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Sort/Merge Utility (SORT) (Cont.) 

invoking • Using VMS, 1-37; Sort/Merge, 

SORT-10 

merging files with • Using VMS, 1-42 
optimizing • Sort/Merge, SORT-7 
sorting noncharacter data files with • Using VMS, 
1-40 

sorting records with • Using VMS, 1-37 
specification file • Sort/Merge, SORT-5 
Sort order 

specifying • Sort/Merge, SORT-66 
Source program • VMS Intro, 4-1 
creating • VMS Intro, 4-7, 4-10 
Space 

creating (DSR) • Text Processing, 3-22 
Space flag • DSR Ref, 3-16 
default • DSR Ref, 3-16 
recognizing • DSR Ref, 2-53 
Spacing 

See also Text spacing 
between lines • DSR Ref, 2-116 
lines • DSR Ref, 2-84 
.SPACING command • DSR Ref, 2-116 
SPAWN command • Using VMS, 1-21, 3-5, 8-46; 
Mail, MAIL-28, MAIL-104; DCL Dictionary, 
DCL2-338 to DCL2-342; EVE Ref, EVE-230 
to EVE-231 

and ATTACH command • DCL Dictionary, 
DCL1-49 

EVE editor • Text Processing, 1-67 
restriction on using (EVE) • Text Processing, 1-67 
to create a subprocess • DCL Concepts, 2-3 
Special characters 

inserting • DSR Ref, 2-14 
Special keys 

See also SHOW KEY command 
BACKSPACE • EOT Ref, EDT-2 
DELETE • EDT Ref, EDT-2 
LINEFEED • EDT Ref, EDT-2 
TAB • EDT Ref, EDT-2 
user-defined keys • EDT Ref, EDT-131 
Specification file 

comments • Sort/Merge, SORT-5 
converting previous versions • Sort/Merge, 
SORT-6 

creating • Sort/Merge, SORT-5 
example of • Sort/Merge, SORT-73 
qualifiers • Sort/Merge, SORT-49 

/CDD_PATH_NAME • Sort/Merge, SORT-50 
/CHECK_SEQUENCE • Sort/Merge, SORT-51 
/COLLATING_SEQUENCE • Sort/Merge, 
SORT-52 


Specification file 
qualifiers (Cont.) 

/CONDITION • Sort/Merge, SORT-57 
/DATA • Sort/Merge, SORT-60 
/FIELD • Sort/Merge, SORT-62 
/INCLUDE • Sort/Merge, SORT-64 
/KEY • Sort/Merge, SORT-66 
/OMIT • Sort/Merge, SORT-68 
/PAD • Sort/Merge, SORT-69 
/PROCESS • Sort/Merge, SORT-70 
/STABLE • Sort/Merge, SORT-71 
/WORK_FILES • Sort/Merge, SORT-72 
special considerations • Sort/Merge, SORT-5 
uses for • Sort/Merge, SORT-5, SORT-31 
/SPECIFICATION qualifier • Sort/Merge, SORT-31 
Specifier 

bottom • EDT Ref, EDT-175 
See also Bottom specifier 
buffer • EDT Ref, EDT-261 
See also Buffer specifier 
line mode • EDT Ref, EDT-120 
nokeypad mode • EDT Ref, EDT-265 
buffer-1 • EDT Ref, EDT-125 
See also Buffer-1 specifier 
buffer-2 • EDT Ref, EDT-125 
See also Buffer-2 specifier 
character • EDT Ref, EDT-269 
See also Character specifier 
count • EDT Ref, EDT-261 
See also Count specifier 
nokeypad mode • EDT Ref, EDT-274 
entity • EDT Ref, EDT-261 
See also Entity specifier 
nokeypad mode • EDT Ref, EDT-285 
file specification • EDT Ref, EDT-138 
See also File specification specifier 
increment • EDT Ref, EDT-138 
See also Increment specifier 
initial ♦ EDT Ref, EDT-138 
See also Initial specifier 
key name • EDT Ref, EDT-130 
See also Key name specifier 
macro name • EDT Ref, EDT-133 
See also Macro name specifier 
"n" • EDT Ref, EDT-137 
See also "n" specifier 
nokeypad mode • EDT Ref, EDT-122 
number • EDT Ref, EDT-262 
See also Number specifier 
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Specifier 

prompt type • EDT Ref, EDT-223 
See also Prompt type specifier 
range • EDT Ref, EDT-122 
See also Range specifier 
range-1 • EDT Ref, EDT-125 
See also Range-1 specifier 
range-2 • EDT Ref, EDT-125 
See also Range-2 specifier 
sign (+|-)* EDT Ref, EDT-261 
See also Sign (+|-) specifier 
string • EDT Ref, EDT-312 
See also String specifier 
keypad mode • EDT Ref, EDT-99 
line mode • EDT Ref, EDT-241 
nokeypad mode • EDT Ref, EDT-313 
string-1 • EDT Ref, EDT-305 
See also String-1 specifier 
string-2 • EDT Ref, EDT-305 
See also String-2 specifier 
subtopic* EDT Ref, EDT-145 
See also Subtopic specifier 
top • EDT Ref, EDT-175 
See also Top specifier 
topic • EDT Ref, EDT-145 
See also Topic specifier 
width • EDT Ref, EDT-190 
See also Width specifier 
SPECINS • EDT Ref, EDT-97 

See also DEC Multinational Character Set 
SPECINS keypad function 
EDT • Text Processing, 2-21 
SPELL command • EVE Ref, EVE-232 
SPLIT WINDOW command • Using VMS, 8-35; EVE 
Ref, EVE-233 

EVE editor • Text Processing, 1-56 
in window environment (EVE) • Text Processing, 
1-56 

SSEL (search and select) command • EDT Ref, 
EDT-312 

See also Locating text 

/STABLE qualifier •Sort/Merge, SORT-32, SORT-71 
START/CPU command • DCL Dictionary, DCL2-343 
to DCL2-344 

START OF LINE command • Using VMS, 8-9; EVE 
Ref, EVE-234 

moving the cursor with (EVE) • Text Processing, 
1-10 

Start position • EVE Ref, 1-18 


START/QUEUE command • DCL Concepts, 8-7; 

DCL Dictionary, DCL2-345 to DCL2-354 
START/QUEUE/MANAGER command • DCL 
Dictionary, DCL2-355 to DCL2-356 
Startup command 

example • EDT Ref, EDT-134 
Startup command file • EDT Ref, EDT-183 
creating • EDT Ref, EDT-7 
displaying • EDT Ref, EDT-209 
processing • EDT Ref, EDT-173, EDT-178, 
EDT-213 

with DEFINE MACRO • EDT Ref, EDT-133 
Startup file 

in EDT • Using VMS, 8-71; Text Processing, 
2-51, 2-52, 2-53 
in EVE 

See also Command file 
See also Initialization file 
See also Section file 
customizing editing sessions with • Text 
Processing, 1-71 

types of attributes for* Text Processing, 1-74 
START/ZONE command • DCL Dictionary, DCL2-357 
/START_POSITION qualifier • EVE Ref, 1-18 
Statistics 

sample display • Sort/Merge, SORT-33 
/STATISTICS qualifier • Sort/Merge, SORT-33 
Status 
displaying 

current process • DCL Dictionary, DCL2-319 
device • DCL Dictionary, DCL2-246, 
DCL2-264 

process • DCL Dictionary, DCL2-246 
system • DCL Dictionary, DCL2-246 
$STATUS • Using VMS, 5-4; DCL Concepts, 5-2; 
DCL Dictionary, DCL2-182 
changing* DCL Dictionary, DCL1-222, DCL2-49 
commands that do not set • Command 
Procedures, 7-2 

definition • Command Procedures, 7-1 
format of • Command Procedures, 7-1 
severity of error condition • Command Procedures, 
7-2 

testing for successful (odd) value • Command 
Procedures, 7-2 

value with SET NOON • Command Procedures, 
7-5 

Status code 

controlling command interpreter response to • DCL 
Dictionary, DCL2-182 
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Status line 
definition 

EVE • Text Processing, 1-2 
with mouse • EVE Ref, EVE-25, EVE-27, 
EVE-92, EVE-151 
Status messages •Mail, MAIL-17 
/STAY qualifier • EDT Ref, EDT-240 
with TYPE • EDT Ref, EDT-251 
STOP/QUEUE/ENTRY command 
with a batch job • VMS Intro, 6-4 
with a print job • VMS Intro, 6-2 
STOP command • Using VMS, 1-21, 6-4, 6-32; 
Command Procedures, 5-16; DCL Dictionary, 
DCL2-358 to DCL2-360 
See also Ctrl/C 
See also Ctrl/Y 
See also EXIT command 
and detached process image • DCL Dictionary, 
DCL2-55 

and subprocess image • DCL Dictionary, DCL2-55 
detached process • DCL Dictionary, DCL2-358 
process • DCL Dictionary, DCL2-358 
runaway magnetic tape • DCL Dictionary, 

DCL1—241 

subprocess • DCL Dictionary, DCL2-358 
terminating command execution • DCL Concepts, 
2-2, 2-3 

STOP/CPU command • DCL Dictionary, DCL2-361, 
DCL2-362 

STOP/QUEUE/ABORT command • DCL Dictionary, 
DCL2-365 to DCL2-366 
STOP/QUEUE command • DCL Dictionary, 

DCL2-363 to DCL2-364 

STOP/QUEUE/ENTRY command • DCL Dictionary, 
DCL2-367 to DCL2-368 
STOP/QUEUE/MANAGER command • DCL 
Dictionary, DCL2-369 

STOP/QUEUE/NEXT command ♦ DCL Dictionary, 
DCL2-370 

and DELETE/QUEUE command • DCL Dictionary, 
DCL1-143 

STOP/QUEUE/REQUEUE command • DCL 
Dictionary, DCL2-371 to DCL2-373 
STOP/QUEUE/RESET command • DCL Dictionary, 
DCL2-374 

STOP/ZONE command • DCL Dictionary, DCL2-375 
Storage bit map file • Files and Devices, A-2 
STORE TEXT command • Using VMS, 8-15; EVE 
Ref, EVE-235 

moving text with (EVE) • Text Processing, 1-19 
using with search string (EVE) • Text Processing, 
1-20 

Stream record type • Files and Devices, B-14 


String 

concatenation • DCL Concepts, 5-5, 6-1, 6-2 
continuation over multiple lines • DCL Concepts, 

5- 5 

converting to an integer value • DCL Concepts, 

6 - 12 

definition • DCL Concepts, 5-5, 6-1 
multiple string values in an expression • DCL 
Concepts, 6-1 

reduction • DCL Concepts, 6-2 
rules for creating • DCL Concepts, 5-5 
String-1 specifier 

with S (substitute) • EDT Ref, EDT-305 
with SUBSTITUTE • EDT Ref, EDT-243 
with SUBSTITUTE NEXT • EDT Ref, EDT-247 
String-2 specifier 

with S (substitute) • EDT Ref, EDT-305 
with SUBSTITUTE • EDT Ref, EDT-243 
with SUBSTITUTE NEXT • EDT Ref, EDT-247 
:= (string assignment) command • DCL Dictionary, 
DCL1-5 to DCL1-8 
String expression 

comparison operators • DCL Concepts, 6-2 
examples • DCL Concepts, 6-2, 6-3 
rules for creating • DCL Concepts, 6-1 
Strings 

comparing, using operators • Command 
Procedures, 5-7 
String specifier 

keypad mode • EDT Ref, EDT-99 
line mode • EDT Ref, EDT-241 
nokeypad mode* EDT Ref, EDT-313 
with DEFINE KEY • EDT Ref, EDT-130 
with SET ENTITY • EDT Ref, EDT-176 
with SET PROMPT • EDT Ref, EDT-186 
with SET TEXT • EDT Ref, EDT-200 
with SSEL (search and select) • EDT Ref, 
EDT-312 

with XLATE • EDT Ref, EDT-332 
String variable 

in VAXTPU procedure* Text Processing, 1-69 
Structure level 

defining for disks • DCL Dictionary, DCL1-247 
.STYLE HEADERS command • DSR Ref, 2-117 
Subdirectory • VMS Intro, 3-7; Using VMS, 2-1 
creating • VMS Intro, 3-8; Using VMS, 2-21; 
DCL Concepts, 3-7; DCL Dictionary, 
DCL1-89 

definition • Using VMS, 2-6; DCL Concepts, 3-7 
setting default to another • Using VMS, 2-22 
syntax • Using VMS, 2-7 
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Subindex flag • DSR Ref, 3-17 
default • DSR Ref, 3-17 
recognizing • DSR Ref, 2-54 
/SUBJECT qualifier • Mail, MAIL-4, MAIL-6, MAIL-23 
SUBMIT command • VMS Intro, 5-11, 6-3; Using 
VMS, 3-8; Files and Devices, 4-1; DCL 
Dictionary, DCL1-269, DCL2-376 to DCL2-385 
specifying multiple command procedures with • 
Command Procedures, 8-3 
with batch job command procedure • Command 
Procedures, 1-6, 8-1 
.SUBPAGE command • DSR Ref, 2-119 
Subprocess • Using VMS, 3-1 
See also SPAWN command 
accounting • DCL Dictionary, DCL2-55 
and job tree • Using VMS, 3-3, 3-5 
and process identification number • Using VMS, 
3-7 

assigning resource quota to • DCL Dictionary, 
DCL2-54 

context • Using VMS, 3-7 
creating • Using VMS, 3-5 

with SPAWN command • DCL Concepts, 2-3 
creating (EVE) • Text Processing, 1-67 
creating specific (EVE) • Text Processing, 1-67 
creating with RUN command • DCL Dictionary, 
DCL2-53 

creating with SPAWN command • DCL Dictionary, 
DCL2-338 

defining attributes • DCL Dictionary, DCL2-54 
defining equivalence names for process- 

permanent logical names • DCL Dictionary, 
DCL2-53 

definition • Using VMS, 3-5 
deleting • Using VMS, 3-6 
displaying characteristics of • DCL Dictionary, 
DCL2-302 

displaying quota • DCL Dictionary, DCL2-304 
exiting from • Using VMS, 3-6 
image hibernation • DCL Dictionary, DCL2-55 
leaving (EVE) • Text Processing, 1-67 
naming with RUN/PROCESS_NAME • DCL 
Dictionary, DCL2-55 

scheduling wakeup • DCL Dictionary, DCL2-57 
specifying default working set • DCL Dictionary, 
DCL2-61 

specifying quotas • DCL Dictionary, DCL2-57 
switching control of input stream to • DCL 
Dictionary, DCL1-49 

with ATTACH command • EVE Ref, EVE-4 
with DCL command • EVE Ref, EVE-32 
with SPAWN command • EVE Ref, EVE-230 


Subprocess (Cont.) 

with SPELL command • EVE Ref, EVE-232 
Subroutine 

termination of GOSUB • DCL Dictionary, DCL2-49 
SUBROUTINE command • Using VMS, 6-26; DCL 
Dictionary, DCL1-53, DCL1-54, DCL2-386 
SUBS command ♦ EDT Ref, EDT-100 
See also Replacing text 
SUBS keypad function 

EDT • Text Processing, 2-20 
SUBSTITUTE command • Using VMS, 8-64; EDT 
Ref, EDT-243 
See also Replacing text 
EDT editor • Text Processing, 2-28 
Substitute flag • DSR Ref, 3-18 
default • DSR Ref, 3-18 
example • DSR Ref, 3-18 
pairing • DSR Ref, 3-18 
recognizing • DSR Ref, 2-55 
SUBSTITUTE NEXT command • EDT Ref, EDT-247 
See also Replacing text 
EDT editor • Text Processing, 2-28 
Substitution 

See Symbol substitution 
Substitution operator 

ampersand (&) • DCL Concepts, 7-3 
apostrophe (') • DCL Concepts, 7-2 
definition • DCL Concepts, 7-2 
order of evaluation • DCL Concepts, 7-3, 7-4 
Substring 

replacing • Using VMS, 5-16 
.SUBTITLE command • Text Processing, 3-38, 3-39; 

DSR Ref, 2-120 
Subtitle within running head 
See Running head 
Subtopic specifier 

with HELP • EDT Ref, EDT-145 
SUMSLP description • DCL Dictionary, DCL1-185 
Supervisor mode 

See Access mode 

Suspending terminal display • Using VMS, 1-23; 

DCL Concepts, 2-7, 2-8 
Swapping 

for created process • DCL Dictionary, DCL2-60 
process 

enabling or disabling swap mode • DCL 
Dictionary, DCL2-193 

Switch-hook character* VMS Intro, 1-15; Using 
VMS, 1-36; Phone, PHONE-6, PHONE-8 
Symbol • VMS Intro, 5-1 

abbreviating ♦ Using VMS, 5-4 
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Symbol (Cont.) 

as another symbol • Using VMS, 5-10 
as foreign command • Using VMS, 1-7, 5-1 
assigning value with READ command • DCL 
Dictionary, DCL2-28 
assignment • Using VMS, 5-2 
as variables • Command Procedures, 2-7 
binary overlay in • DCL Dictionary, DCL1-1 
character overlays in • DCL Dictionary, DCL1-6 
character string • Using VMS, 5-2 
concatenation • DCL Concepts, 7-2 
controlling access to • Using VMS, 5-5 
creating • Using VMS, 5-2; Command 
Procedures, 2-7 

DCL commands to use with • Using VMS, 5-5 
defined as a lexical function • Using VMS, 5-9; 
DCL Concepts, 5-6 

defined as an expression • DCL Concepts, 5-7 
defined as another symbol • DCL Concepts, 5-7 
defining in command procedure • Using VMS, 6-9 
definition • Using VMS, 1-23, 5-1; DCL 
Concepts, 5-1; Command Procedures, 

2-7 

deleting • Using VMS, 5-5; Command 
Procedures, 2-9 

from global symbol table • DCL Dictionary, 
DCL1-145 

from local symbol table • DCL Dictionary, 
DCL1-145 

determining the value of • Command Procedures, 
2-7 

differences from logical names • Command 
Procedures, 2-15 

displaying • Using VMS, 5-5; DCL Dictionary, 
DCL2-320 

in command procedure • Using VMS, 6-12 
evaluating using IF command • Command 
Procedures, 5-8 
evaluation • Using VMS, 5-3 
forcing symbol substitution with an apostrophe • 
DCL Concepts, 5-7 

general assignment • DCL Dictionary, DCL1-1 
global • Using VMS, 5-3, 5-6; DCL Concepts, 

5-1; Command Procedures, 2-7 
indicating a numeric value • Using VMS, 5-3, 5-8; 

DCL Concepts, 5-3, 5-5 
interactive assignment- in command procedure • 
DCL Dictionary, DCL1-262 
iterative substitution • DCL Concepts, 7-5 
local • Using VMS, 5-2, 5-5; DCL Concepts, 5-1; 

Command Procedures, 2-7 
logical data • Using VMS, 5-10 
masking • DCL Dictionary, DCL2-218 


Symbol (Cont.) 

masking the value of • Command Procedures, 2-8 
numeric overlay with • Using VMS, 5-17 
obtaining an output value with • Command 
Procedures, 3-11 

passing to a command procedure • Using VMS, 

6- 7 

precedence • Using VMS, 5-3 
preventing assignment in subprocesses • Using 
VMS, 3-8 

repetitive substitution • DCL Concepts, 7-5 
rules for abbreviating • DCL Concepts, 5-4 
rules for creating • DCL Concepts, 5-2 
scope • Using VMS, 5-5 
search order • DCL Concepts, 5-3 
string assignment • DCL Dictionary, DCL1-5 
substitution • Using VMS, 5-6; Command 
Procedures, 2-14 
automatic • Using VMS, 5-6 
forced • Using VMS, 5-6 
order of • Using VMS, 5-6 
substring replacement with • Using VMS, 5-16 
symbol table search order • Using VMS, 5-5 
two ways to indicate a character string value • 
DCL Concepts, 5-3, 5-5 
undefined • DCL Concepts, 7-7 
used as variable • Using VMS, 5-2 
used in expressions • Using VMS, 5-7 to 5-8, 
5-11 to 5-19 

uses • Using VMS, 5-1 to 5-2; DCL Concepts, 
5-1 

with the WRITE command • Command 
Procedures, 6-5 
Symbolic name 

defining* DCL Dictionary, DCL1-1, DCL1-5 
Symbols for characters • EDT Ref, A-1 
Symbol substitution 

See also Iterative substitution 
See also Repetitive substitution 
See also Substitution operator 
automatic evaluation • DCL Concepts, 7-1 
definition • DCL Concepts, 7-1 
in a command procedure • DCL Concepts, 7-4 
in a lexical function • DCL Concepts, 7-1 
performed by command interpreter • DCL 
Concepts, 7-4 

rules for • DCL Concepts, 7-1 
using an ampersand (&) • DCL Concepts, 7-3 
using an apostrophe (’) • DCL Concepts, 7-2 
within a quoted character string • DCL Concepts, 

7- 3, 7-4, 7-5 
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Symbol table 

See also Local symbol table 
search order • DCL Concepts, 5-3 
SYNCHRONIZE command • Command Procedures, 
8-10; DCL Dictionary, DCL2-387 to DCL2-388 
Syntax 

cluster device specification • DCL Concepts, 3-6 
DCL command line • DCL Concepts, 1-3 
device specification • DCL Concepts, 3-4 
directory specification • DCL Concepts, 3-9 
file specification • DCL Concepts, 3-1,3-13 
file specification on a tape volume • DCL 
Concepts, 3-16 

for date and time values • DCL Concepts, 1-14 to 
1-17 

foreign command • DCL Concepts, 5-8 
lexical function • DCL Concepts, 5-6 
logical name definition • DCL Concepts, 4-2 
node specification • DCL Concepts, 3-2, 3-3 
parameter specification • DCL Concepts, 1-6 
qualifier value • DCL Concepts, 1-9 
symbol definition • DCL Concepts, 5-2 
UIC • DCL Concepts, 8-1 
SYS$BATCH • Using VMS, 3-8 
SYSSCOMMAND • VMS Intro, 3-11; DCL Concepts, 
4-5, 4-23 

redefining • Using VMS, 4-19; DCL Concepts, 
4—26 

SYS$COMMAND process permanent file • Command 
Procedures, 2-6 

changing the default value of • Command 
Procedures, 2-7 

in batch job command procedure • Command 
Procedures, 2-6 

in interactive command procedure • Command 
Procedures, 2-6 

using to define SYS$INPUT as your terminal • 
Command Procedures, 3-6 
SYS$COMMON • DCL Concepts, 4-7 
SYS$DISK • VMS Intro, 3-11; DCL Concepts, 4-5 
SYS$ERROR • VMS Intro, 3-11; DCL Concepts, 
4-5, 4-23 

redefining • Using VMS, 4-19; DCL Concepts, 
4-25 

specifying equivalence name with RUN command 
• DCL Dictionary, DCL2-57 
SYSSERROR process permanent file • Command 
Procedures, 2-6 

changing the default value of • Command 
Procedures, 2-7 

in batch job command procedure • Command 
Procedures, 2-6, 8-5 


SYS$ERROR process permanent file (Cont.) 

in interactive command procedure • Command 
Procedures, 2-6 

SYS$ERROR_LOG • DCL Concepts, 4-7 
SYS$EXAMPLES • DCL Concepts, 4-7 
SYS$HELP • DCL Concepts, 4-7 
SYSSINPUT • VMS Intro, 3-11; DCL Concepts, 4-5, 
4-23; Command Procedures, 2-6 
changing the default value of • Command 
Procedures, 2-7 

in batch job command procedure • Command 
Procedures, 2-6, 8-4 

in interactive command procedure • Command 
Procedures, 2-6 

redefining • Using VMS, 4-18; DCL Concepts, 
4-24 

in command procedure • Using VMS, 6-10 
redefining as a data file • Command Procedures, 
3-7 

redefining as a terminal • Command Procedures, 

3— 6 

redefining to allow input to an image • Command 
Procedures, 3-5 

specifying equivalence name with RUN command 

• DCL Dictionary, DCL2-57 
SYS$INSTRUCTION • DCL Concepts, 4-7 
SYSSLIBRARY • DCL Concepts, 4-7 
SYS$LOGIN • DCL Concepts, 4-6 
SYS$LOGIN_DEVICE • DCL Concepts, 4-6 
SYSSMAINTENANCE • DCL Concepts, 4-7 
SYS$MANAGER • DCL Concepts, 4-7 
SYS$MANAGER:ACCOUNTING.DAT • DCL 

Dictionary, DCL2-91 
SYS$MESSAGE • DCL Concepts, 4-7 
SYS$NET • DCL Concepts, 4-5 
SYSSNODE • DCL Concepts, 4-7 
SYS$OUTPUT • VMS Intro, 3-11, 5-5; DCL 
Concepts, 4-5, 4-23; Command Procedures, 
2—6 

changing the default value of • Command 
Procedures, 2-7 

displaying file on • DCL Dictionary, DCL2-389 
in batch job command procedure • Command 
Procedures, 2-6, 8-5 

in interactive command procedure • Command 
Procedures, 2-6 

redefining • Using VMS, 4-18; DCL Concepts, 

4- 24; Command Procedures, 3-8 
specifying equivalence name with RUN command 

• DCL Dictionary, DCL2-58 
SYS$PRINT • Using VMS, 2-18 

and batch job log files • Using VMS, 3-9 
SYS$REM_ID • DCL Concepts, 4-6 
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SYS$REM_NODE • DCL Concepts, 4-6 
SYSSSCRATCH • DCL Concepts, 4-6 
SYS$SHARE • DCL Concepts, 4-7 
SYS$SPECIFIC • DCL Concepts, 4-7 
SYS$SYLOGIN 

executing • DCL Dictionary, DCL1-392 
SYS$SYSDEVICE • DCL Concepts, 4-7 
SYS$SYSROOT • DCL Concepts, 4-7 
SYS$SYSTEM • DCL Concepts, 4-8, 5-8 
SYS$TEST • DCL Concepts, 4-8 
SYS$UPDATE • DCL Concepts, 4-8 
SYSLOST directory • DCL Dictionary, DCL2-146 
SYSPRV privilege • DCL Concepts, 8-6 
System 

accessing • DCL Dictionary, DCL1-392 
changing 

date • DCL Dictionary, DCL2-234 
password • DCL Dictionary, DCL2-184 
time • DCL Dictionary, DCL2-234 
displaying 

information on • DCL Dictionary, DCL2-246 
status • DCL Dictionary, DCL2-246 
System buffers • EVE Ref, EVE-40 
SYSTEM category 

definition • DCL Concepts, 8-3 
System-dependent field • Files and Devices, B-15 
System directory logical name table 
default contents • DCL Concepts, 4-9 
list of default contents of • Using VMS, 4-10 
System failure 

see /RECOVER qualifier 
System help files • DCL Dictionary, DCL1-231 
System image 

creating • DCL Dictionary, DCL1-389 
System logical name table 

canceling entries* DCL Dictionary, DCL1-106 
default contents • DCL Concepts, 4-7 
definition • Using VMS, 4-7; DCL Concepts, 4-7 
including logical name • DCL Dictionary, DCL1-41, 
DCL1-116 

list of default contents of • Using VMS, 4-7 
logical name for* Using VMS, 4-7; DCL 
Concepts, 4-7 
System login image 

and detached process • DCL Dictionary, DCL2-56 
System management • Mail, MAIL-14 
System object 

definition • DCL Concepts, 8-1 
System ownership category • Using VMS, 7-3 


System performance 

displaying availability and use of 

resources • DCL Dictionary, DCL2-292 
System-permanent logical name • Using VMS, 4-20 
System privilege • Files and Devices, 2-1 
System processes 

displaying list • DCL Dictionary, DCL2-322 
System rights database 

definition • DCL Concepts, 8-2 
System time 

changing • DCL Dictionary, DCL2-234 
SYSUAF.DAT • Using VMS, 7-1 


T 


TA90E tape drive 

support for* DCL Dictionary, DCL1-246, 
DCL2-177 

using /MEDIA_FORMAT qualifier • DCL Dictionary, 
DCL1-246, DCL2-177 
Tab 

establishing position of • EDT Ref, EDT-30 
preset setting • EDT Ref, EDT-103 
preset value • EDT Ref, EDT-315 
setting • DSR Ref, 2-122 
setting level count • EDT Ref, EDT-34, EDT-35 
TAB 

See also Formatting, text 
keypad mode • EDT Ref, EDT-103 
TAB ADJUST command • EDT Ref, EDT-249 
See also Tabbing functions 
Tabbing functions 

Ctrl/A • EDT Ref, EDT-30 

Ctrl/C • EDT Ref, EDT-32 

Ctrl/D ’EDT Ref, EDT-34 

Ctrl/E • EDT Ref, EDT-35 

Ctrl/H • EDT Ref, EDT-22 

Ctrl/I • EDT Ref, EDT-103 

Ctrl/T • EDT Ref, EDT-45 

GOLD/A • EDT Ref, EDT-30 

GOLD/D • EDT Ref, EDT-34 

GOLD/E • EDT Ref, EDT-35 

GOLD/T -EDTRef, EDT-45 

SET TAB • EDT Ref, EDT-30, EDT-196 

SHOW TAB • EDT Ref, EDT-230 

TAB • EDT Ref, EDT-103, EDT-315 

TAB ADJUST • EDT Ref, EDT-249 

TADJ (tab adjust) • EDT Ref, EDT-317 

TC (tab compute) • EDT Ref, EDT-318 

TD (tab decrement) • EDT Ref, EDT-320 
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Tabbing functions (Cont.) 

Tl (tab increment) • EDT Ref, EDT-323 
TAB command • EVE Ref, EVE-236 to EVE-237 
nokeypad mode* EDT Ref, EDT-315 
See also Tabbing functions 
Tab key 

formatting text with (EVE) • Text Processing, 1-39 
TAB key • Using VMS, 1-18; DCL Concepts, 2-5 
TAB keypad mode 
See Formatting, text 
Table of contents 

creating • DCL Dictionary, DCL2-73; DSR Ref, 
2-33 

creating with DSR • Text Processing, 3-48 
formatting • DSR Ref, 2-107, 5-1, A-4 
identifying current version • DSR Ref, 5-4 
producing • DSR Ref, 5-1 
producing with DSR • Using VMS, 9-17 
Table of Contents Utility • DSR Ref, 5-1 
features of • DSR Ref, 5-1 
qualifiers • DSR Ref, 5-3 
Tab modes • EVE Ref, EVE-210, EVE-236 
Tab stops • EVE Ref, EVE-210 
.TAB STOPS command • Text Processing, 3-12; 

DSR Ref, 2-122 
Tab value • EDT Ref, EDT-230 
TADJ (tab adjust) command • EDT Ref, EDT-317 
See also Tabbing functions 
Tag sort • Using VMS, 1-39 

reasons for selecting • Sort/Merge, SORT-29 
specifying • Sort/Merge, SORT-70 
Tape 

disabling operator status • DCL Dictionary, 

DCL2—40 

enabling operator status • DCL Dictionary, 
DCL2-40 

establishing operational status for • DCL 
Dictionary, DCL2-123 

modifying RMS defaults for file operations • DCL 
Dictionary, DCL2-214 
Tape initializing 

using REPLY/BLANKTAPE • DCL Dictionary, 
DCL2-40 

using REPLY/INITIALIZE_TAPE • DCL Dictionary, 
DCL2-40 

Tape mark • Files and Devices, B-3 
Tape marker 

BOT • Files and Devices, B-3 
EOT • Files and Devices, B-3 
Tape volume 
See also Volume 


Tape volume (Cont.) 

file specification • DCL Concepts, 3-16 
Task specification string 

on a network • DCL Concepts, 3-3 
TC (tab compute) command • EDT Ref, EDT-318 
See also Tabbing functions 
TD (tab decrement) command • EDT Ref, EDT-320 
See also Tabbing functions 
TECO description • DCL Dictionary, DCL1-186 
Telephone Utility 
See Phone Utility 

Temporary defaults in an input file list * DCL 
Concepts, 3-16 
Terminal 

See also SET TERMINAL command 
See also SHOW TERMINAL command 
default characteristics • DCL Dictionary, DCL1-392 
See LOGIN Procedure command 
display 

stopping and starting • Using VMS, 1-19, 

1-23 

displaying 

characteristics of • DCL Dictionary, DCL2-326 
file at • DCL Dictionary, DCL2-389 
establishing as spooled • DCL Dictionary, 
DCL2-123 

hardcopy • VMS Intro, 1-1 
I/O 

in command procedure • Using VMS, 6-10, 
6-12 

modifying characteristics of • DCL Dictionary, 
DCL2-221 

protection • Using VMS, 7-12; Files and Devices, 
2-14 

sending message to • DCL Dictionary, DCL2-38 
video display • VMS Intro, 1-1 
virtual* DCL Dictionary, DCL1-60, DCL1-168 
Terminal attributes 

changing repeat feature • EDT Ref, EDT-189 
changing terminal type • EDT Ref, EDT-198 
displaying • EDT Ref, EDT-206, EDT-224, 
EDT-225 

displaying prompt settings • EDT Ref, EDT-223 
displaying terminal settings • EDT Ref, EDT-232 
preventing keypad key repetition • EDT Ref, 
EDT-171 

redefining prompt string • EDT Ref, EDT-186 
SHOW PROMPT • EDT Ref, EDT-223 
SHOW QUIET • EDT Ref, EDT-224 
SHOW REPEAT • EDT Ref, EDT-225 
SHOW TERMINAL • EDT Ref, EDT-232 
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Terminal attributes (Cont.) 

silencing terminal bell • EDT Ref, EDT-188 
suppressing summary information • EDT Ref, 
EDT-195 
Terminal display 

stopping and starting • DCL Concepts, 2-7 
Terminal emulator 

creating • DCL Dictionary, DCL1-97 
Terminal queue 

definition • Using VMS, 2-18 
Terminal requirements • Phone, PHONE-3 
Terminal session 

logging in • DCL Dictionary, DCL1-392 
logging out* DCL Dictionary, DCL1-396 
Terminal settings 

See also SHOW TERMINAL command 
hardcopy • EDT Ref, EDT-123, EDT-232 
VT100-series* EDT Ref, EDT-232 
Terminating 

commands • DSR Ref, 1-3 
Termination 

of command procedure • DCL Dictionary, 
DCL1-222 

of GOSUB subroutine • DCL Dictionary, DCL2-49 
of terminal session • DCL Dictionary, DCL1-396 
Termination message • DSR Ref, 4-15 
Terminator • Text Processing, 3-3 
Testing 

the value of an expression • DCL Dictionary, 
DCL1-237 

.TEST PAGE command • DSR Ref, 2-124 
Text 

analyzing 

in object file • DCL Dictionary, DCL1-29 
boldfacing with DSR • Text Processing, 3-46 
deleting with EDT • Text Processing, 2-14 
filling (DSR) • Text Processing, 3-14 
formatting into chapters using DSR • Text 
Processing, 3-33 

indenting (DSR) • Text Processing, 3-19 
justifying (DSR) • Text Processing, 3-14 
organizing into sections using DSR • Text 
Processing, 3-29 

underlining with DSR • Text Processing, 3-46 
Text back-end converter 

processing options in • DCL Dictionary, DCL1-67 
Text editor 

EVE • DCL Dictionary, DCL1-189 
VAXTPU • DCL Dictionary, DCL1-189 
Text file 
formatting 
See DSR 


Text formatting • DSR Ref, 1-1, A-2 
centering text • DSR Ref, 2-11 
discarding blank lines • DSR Ref, 2-73 
dividing into sections • DSR Ref, A-3 
emphasizing • DSR Ref, A-3 
example 

.AUTOTABLE • DSR Ref, 2-7 
filling lines • DSR Ref, 2-39 
filling text • DSR Ref, A-2 
footnotes • DSR Ref, 2-58 
hyphenation • DSR Ref, 3-11 
indentation • DSR Ref, 2-69, 5-4 
inserting blank lines • DSR Ref, 2-9 
inserting footnotes • DSR Ref, A-3 
inserting notes • DSR Ref, A-3 
justifying • DSR Ref, 2-3, 2-71, A-2 
keeping blank lines • DSR Ref, 2-73 
line breaks • DSR Ref, 2-44, 3-7 
lines per page • DSR Ref, 6-7 
literal output • DSR Ref, 2-83 
option words • DSR Ref, 4-9 
space between words • DSR Ref, 3-16 
spaces for figures • DSR Ref, 2-36 
spacing between lines* DSR Ref, 2-115, 2-116 
spacing between words • DSR Ref, 2-53 
with DSR • Using VMS, 9-1 
wrapping lines • DSR Ref, 2-84 
Text processing • DSR Ref, 1-1 
Text spacing 

changing • DSR Ref, 2-116 
horizontal • DSR Ref, A-2 
lines • DSR Ref, 2-84 
vertical • DSR Ref, A-2 

TGSEL (toggle select) command • EDT Ref, EDT-322 
THEN keyword 

and IF command • DCL Dictionary, DCL1-237 
Tl (tab increment) command • EDT Ref, EDT-323 
See also Tabbing functions 
Time 

See also Absolute time 
See also Combination time 
See also Delta time 

changing system • DCL Dictionary, DCL2-234 
CPU quota for created process • DCL Dictionary, 
DCL2-60 

CPU used by current process • DCL Dictionary, 
DCL2-319 

displaying • DCL Dictionary, DCL2-328 
specifying absolute • DCL Concepts, 1-14 
specifying absolute and delta combinations • DCL 
Concepts, 1-16 
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Time (Cont.) 

specifying absolute and delta date and time 
combinations • Using VMS, 1-16 
specifying absolute date and time • Using VMS, 
1-15 

specifying delta • DCL Concepts, 1-15 
specifying delta date and time • Using VMS, 1-16 
$$Time • DSR Ref, 3-18 
.TITLE command • Text Processing, 3-37, 3-38, 
3-42; DSR Ref, 2-125 

TOP command • Using VMS, 8-9, 8-57; EDT Ref, 
EDT-105, EDT-325; EVE Ref, EVE-238 
See also Cursor movement 
See also Moving text 

moving the cursor with (EVE) • Text Processing, 
1-10 

Topic specifier 

with HELP • EDT Ref, EDT-145 
TOP keypad function 

EDT • Text Processing, 2-10 
Top-level directory 

See also User file directory 
definition • DCL Concepts, 3-7 
Top-level directory file • Using VMS, 2-1, 2-6 
Top specifier 

with SET CURSOR • EDT Ref, EDT-175 
TPU 

See VAXTPU 

TPU$COMMAND.TPU file • EVE Ref, 1-8 
TPU$COMMAND logical name • DCL Dictionary, 
DCL1-191; EVE Ref, 1-8 
TPU$DEBUG logical name • DCL Dictionary, 
DCL1-193; EVE Ref, 1-10 
TPU$DISPLAY_MANAGER logical name • DCL 
Dictionary, DCL1-193; EVE Ref, 1-10 
TPU$JOURNAL logical name • DCL Dictionary, 
DCL1-196; EVE Ref, 1-21 
TPU$SECTION logical name • DCL Dictionary, 
DCL1-200; EVE Ref, 1-16, 1-24 
TPU$WORK logical name • DCL Dictionary, 
DCL1-202; EVE Ref, 1-19 
TPU command • Using VMS, 8-45; EVE Ref, 
EVE-239 

EVE editor • Text Processing, 1-68 
TPU editor 

as default MAIL editor • Using VMS, 1-35 
Trailer label • Files and Devices, 1-7, B-3, B-16 
Transfer modes 

EXCHANGE/NETWORK command • DCL 
Dictionary, DCL1-215 
True expression 

and IF command • DCL Dictionary, DCL1-237 


TT • DCL Concepts, 4-5 

TWO WINDOWS command • Using VMS, 8-35; 

EVE Ref, EVE-240 

in window environment (EVE) • Text Processing, 
1-56 

TYPE command • VMS Intro, 2-5; Using VMS, 6-12; 
Command Procedures, 3-15; DCL Dictionary, 
DCL2-389 to DCL2-394; EDT Ref, EDT-251 
See also Displaying text 
and wildcard characters • Using VMS, 2-15 
displaying files with • Using VMS, 2-15 
EDT editor • Text Processing, 2-25 
executing command procedure on remote node 
with • Using VMS, 6-2 
foreign volumes • Files and Devices, 5-10 
magnetic tape • Files and Devices, 4-18 
using to execute command procedure on remote 
node • Command Procedures, 1-6 
TYPE WHOLE command 

EDT editor • Text Processing, 2-22 


u 


UAF (user authorization file) 

and detached process • DCL Dictionary, DCL2-56 
and login procedure • Using VMS, 1-1 
and process characteristics • Using VMS, 1-3, 7-1 
and the Authorize Utility • Using VMS, 7-1 
definition • Using VMS, 7-1 
UFD (user file directory) • Using VMS, 2-1 
See also Directory structure 
See also Top-level directory 
contents of • Using VMS, 2-6 
definition • DCL Concepts, 3-7 
location of • Using VMS, 2-8 
UIC (user identification code) • VMS Intro, 2-8 
alphanumeric • Using VMS, 7-2 
alphanumeric format • DCL Concepts, 8-2 
and process context • Using VMS, 3-3 
changing default • DCL Dictionary, DCL2-236 
default protection • Using VMS, 7-10; Files and 
Devices, 2-8 

examples • DCL Concepts, 8-2 
format • Files and Devices, 2-1 
in a directory name • DCL Concepts, 3-9 
member component • Using VMS, 7-3 
numeric • Using VMS, 7-2 
numeric format • DCL Concepts, 8-1 
object • Using VMS, 7-3 
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UIC (user identification code) (Cont.) 
process • Using VMS, 7-3 
protection • Using VMS, 7-2 
specification • Files and Devices, 3-14 
specifying for directory • DCL Dictionary, DCL1-89 
specifying for files • DCL Dictionary, DCL1-85 
UlC-based protection • Files and Devices, 2—1, 2-12 
See also Access types 
See also Protection code 
See also User category 
default • Files and Devices, 2-8 
definition • DCL Concepts, 8-1 
to bypass • Files and Devices, 2-3 
user categories • DCL Concepts, 8-3 
UIC directory specification 
definition • DCL Concepts, 3-9 
format in a file specification • DCL Concepts, 3-9 
rules for entering • DCL Concepts, 3-9 
translating to named format* DCL Concepts, 3-10 
wildcards • DCL Concepts, 3-21 
ULTRIX wildcards • EVE Ref, EVE-215, EVE-247, 
EVE-248 

UNDC (undelete character) command • EDT Ref, 
EDT-326 

See also Restoring deleted text 
UND C keypad function 

EDT • Text Processing, 2-14 
UND C keypad function (EDT) • Using VMS, 8-59; 
EDT Ref, EDT-106 
See also Restoring deleted text 
Undefined symbol • DCL Concepts, 7-7 
UNDEFINE KEY command • Using VMS, 8-40; EVE 
Ref, EVE-241 

EVE editor* Text Processing, 1-61 
UNDEFINE MENU ENTRY command • EVE Ref, 
EVE-242 
Underline flag 

default • DSR Ref, 3-19 
pairing • DSR Ref, 3-19 
recognizing • DSR Ref, 2-56 
with DSR • Text Processing, 3-46 
/UNDERLINE qualifier • DSR Ref, 4-25, 5-6 
Underlining • DSR Ref, 2-34, 3-19 
See also Emphasizing text 
example • DSR Ref, 3-19 
in table of contents • DSR Ref, 5-6 
UNDL (undelete line) command • EDT Ref, EDT-327 
See also Restoring deleted text 
UND L keypad function 

EDT • Text Processing, 2-14 


UND L keypad function (EDT) • Using VMS, 8-61; 
EDT Ref, EDT-107 
See also Restoring deleted text 
UNDW (undelete word) command • EDT Ref, 
EDT-329 

See also Restoring deleted text 
UND W keypad function 

EDT • Text Processing, 2-14 
UND W keypad function (EDT) • Using VMS, 8-60; 
EDT Ref, EDT-109 
See also Restoring deleted text 
Unit number • VMS Intro, 3-4 
Unit number field 

default value • Using VMS, 2-10; DCL Concepts, 
3-6 

definition • Using VMS, 2-9; DCL Concepts, 3-4 
Unit record device 

definition • Using VMS, 2-8; DCL Concepts, 3-4 
Unloading device 

with DISMOUNT command • DCL Dictionary, 
DCL1-172 

UNLOCK command • DCL Dictionary, DCL2-395 
Unlocking files • DCL Dictionary, DCL2-395 
UNMARK command • Mail, MAIL-59 
UNMODIFIABLE keyword 

SET BUFFER command (EVE) • Text Processing, 
1-50 

UP arrow key • DCL Concepts, 2-7 
keypad mode • EDT Ref, EDT-111 
moving the cursor with • Text Processing, 1-8 
nokeypad mode • EDT Ref, EDT-331 
See also Cursor movement 
recalling commands with • Using VMS, 1-18, 
1-21; DCL Concepts, 2-6 
Update access • Files and Devices, 4-19 
UPPERCASE command • Using VMS, 8-30 
EVE editor* Text Processing, 1-46 
Uppercase flag • DSR Ref, 3-20 
default • DSR Ref, 3-20 
pairing • DSR Ref, 3-20 
recognizing • DSR Ref, 2-57 
UPPERCASE WORD command • Using VMS, 8-36; 
EVE Ref, EVE-243 

formatting text with (EVE) • Text Processing, 1-41 
using with search string (EVE) • Text Processing, 
1-20 

User 

displaying 

disk quota* DCL Dictionary, DCL2-317 
interactive terminal name • DCL Dictionary, 
DCL2-331 
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User 

displaying (Cont.) 

process identification code (PID) • DCL 
Dictionary, DCL2-331 

users on system • DCL Dictionary, DCL2-331 
recording name on disk volume • DCL Dictionary, 
DCL2-242 
User accounts 

in UAF • Using VMS, 7-1 
User authorization file 
See UAF 
User category 

definition • DCL Concepts, 8-3 
group • DCL Concepts, 8-3 
owner • DCL Concepts, 8-3 
system • DCL Concepts, 8-3 
types of access • Files and Devices, 2-2 
world • DCL Concepts, 8-3 
User-defined keys • EDT Ref, EDT-131 
User-defined sequence 

defining • Sort/Merge, SORT-53 
User file directory 
See UFD 

User identification code 
See UIC 
User library 

help* DCL Dictionary, DCL1-234 
User mode 

See Access mode 

User mode assignments • Command Procedures, 3-6 
User name • VMS Intro, 1-1 

specifying at login • DCL Dictionary, DCL1-392 
User password 

setting • DCL Dictionary, DCL2-184 
User profile • Mail, MAIL-14 
User record • Mail, MAIL-72 
User requests 

responding to • DCL Dictionary, DCL2-39 
/USER_MODE qualifier 

redefining SYS$INPUT with • Using VMS, 4-18 
redefining SYS$OUTPUT with • Using VMS, 4-18 
USER_MODE qualifier (DEFINE command) • 
Command Procedures, 3-6 
Utility 

definition • VMS Intro, 1-9 
indexing • DSR Ref, 6-1 
invoking • VMS Intro, 1-9 
mail • VMS Intro, 1-10 
phone • VMS Intro, 1-15 
prompt* VMS Intro, 1-9 
Table of Contents • DSR Ref, 5-1 


V 


Value 

DCL syntax line • DCL Concepts, 1-3 
definition • Using VMS, 1-9; DCL Concepts, 1-3 
in DCL command line* Using VMS, 1-8 
test in expression • DCL Dictionary, DCL1-237 
Variable 

definition • Command Procedures, 2-1 
.VARIABLE command • DSR Ref, 2-126, A-5 
example • DSR Ref, 2-126 
Variable-length record • Files and Devices, B-14 
Variable-length records 

specifying • Sort/Merge, SORT-43 
Variable with fixed-length control records 
specifying • Sort/Merge, SORT-43 
Variant name 

restrictions • DSR Ref, 4-26 
syntax • DSR Ref, 4-26 
/VARIANT qualifier • DSR Ref, 2-126, 4-26 
VAX Text Processing Utility 
See VAXTPU 

VAXTPU (VAX Text Processing Utility) 
batch editing *DCL Dictionary, DCL1-191, 
DCL1-194 

command file • DCL Dictionary, DCL1-191; EVE 
Ref, 1-8 

compiling procedures • EVE Ref, EVE-54, 
EVE-55, EVE-57 

debugger* DCL Dictionary, DCL1-192; EVE Ref, 
1-9 

DECwindows interface • DCL Dictionary, 
DCL1-193, DCL1-195 

display manager* DCL Dictionary, DCL1-193 
executing procedures • EVE Ref, EVE-239 
help on built-in procedures • EVE Ref, EVE-239 
input file • DCL Dictionary, DCL1-189, DCL1-192 
invoking* DCL Dictionary, DCL1-189 
journaling • DCL Dictionary, DCL1-195, DCL1-198 
output file • DCL Dictionary, DCL1-197 
procedures 

help on • EVE Ref, EVE-72 
recovery from system failure • DCL Dictionary, 
DCL1-198 

section file* DCL Dictionary, DCL1-200 
start position • DCL Dictionary, DCL1-202 
work file • DCL Dictionary, DCL1-202 
VAXTPU procedure 

compiling • Text Processing, 1-69 
executing • Text Processing, 1-68 
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VAXTPU procedure (Cont.) 

extending EVE with • Text Processing, 1-69 
rules for writing • Text Processing, 1-69 
using EXTEND EVE command to compile • Text 
Processing, 1-70 
Verification 

modifying for command procedures • DCL 
Dictionary, DCL2-237 
Version limit 

for files in directory • DCL Dictionary, DCL1-90 
Version number • VMS Intro, 2-3; Files and Devices, 
4-17, B—11 

See also File version number 
assigning to files* DCL Dictionary, DCL1-216 
Version number with SHOW SUMMARY command • 
EVE Ref, EVE-226 

VFC (variable with fixed-length control) record format 
• Files and Devices, B-14 
VIEW command • DCL Dictionary, DCL2-396 
Viewport 

See also Screen layout 
description • Phone, PHONE-2 
scrolling ♦ Phone, PHONE-5 
specifying size • Phone, PHONE-7 
Virtual memory 

examining contents* DCL Dictionary, DCL1-209 
replacing contents* DCL Dictionary, DCL1-147 
Virtual terminal 

connecting to • DCL Dictionary, DCL1-60 
disconnecting from • DCL Dictionary, DCL1-168 
VMSMAIL_PROFILE.DATA file • Mail, MAIL-14 
VMS multiprocessing system 

showing attached processor state • DCL 
Dictionary, DCL2-258 

starting attached processor • DCL Dictionary, 
DCL2-343 

stopping attached processor • DCL Dictionary, 
DCL2-361 

VMS NCS • DCL Dictionary, DCL2-1 
VMS Record Management Services 
See VMS RMS 

VMS RMS (Record Management Services) • Files 
and Devices, B-1, B-13, B-14 
attributes • Files and Devices, B-15, B-16 
modifying defaults tor* DCL Dictionary, DCL2-214 
VMS wildcards • EVE Ref, EVE-216, EVE-246, 
EVE-247 

VOL1 label • Files and Devices, 2-4 
See also Volume label 
VOL label 

See Volume label 

VOLSET.SYS reserved file • Files and Devices, A-3 


Volume 

See also Disk 

ANSI-labeled magnetic tape • Files and Devices, 
B—3 

copying files from • Files and Devices, 5-3 
mounting • Files and Devices, 3-12 
continuation • Files and Devices, 3-17 
definition • Using VMS, 2-9; DCL Concepts, 3-5 
deleting disk files • DCL Dictionary, DCL1-131 
dismounting disk and magnetic tape • DCL 
Dictionary, DCL1-170 

displaying disk quota* DCL Dictionary, DCL2-317 
dumping • DCL Dictionary, DCL1-174 
file configurations • Files and Devices, B-3, B-4, 
B-5, B-7 
Files-11 

modifying characteristics of • DCL Dictionary, 
DCL2-240 

recording name on • DCL Dictionary, 
DCL2-242 

foreign • Files and Devices, 3-8 
header labels • Files and Devices, 3-15 
initializing • Files and Devices, 3-3, 3-4, 3-5; 

DCL Dictionary, DCL1-240 
label • Files and Devices, B-3; DCL Dictionary, 
DCL1-240 

label format • Files and Devices, 3-12 
magnetic tape • Files and Devices, 5-2 
ANSI-labeled • Files and Devices, 5-3 
copying files from • Files and Devices, 5-3 
deallocating • Files and Devices, 4-16 
dismounting • Files and Devices, 4-16 
initializing • Files and Devices, 4-15 
mounting • Files and Devices, 3-11 
record format • Files and Devices, 5-3 
writing files to • Files and Devices, 4-15 
modifying characteristics of disk • Files and 
Devices, 4-13 

mounting • Files and Devices, 3-6, 3-8 
See also MOUNT command 
mounting with EXCHANGE • Files and Devices, 
5-11 

mounting without HDR2 labels • Files and Devices, 
B-15 

operator assistance • Files and Devices, 3-7 
owner field • Files and Devices, B-9 
private • Files and Devices, 3-1 
protecting • DCL Dictionary, DCL1-247 
specifying maximum file number • DCL Dictionary, 
DCL1-245 

specifying ownership • DCL Dictionary, DCL1-246 
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Volume accessibility field 

writing characters to • DCL Dictionary , DCL1-245 
Volume identifier field • Files and Devices , 3-17, B-9 
Volume label 

EOF (end-of-file) label • Files and Devices, B-3 
EOV (end-of-volume) label • Files and Devices, 

B—3 

VOL1 label • Files and Devices, B-8 

accessibility field • Files and Devices, B-9 
volume identifier field • Files and Devices, B-9 
VOL label • Files and Devices, B-3 
Volume protection 
See also Protection 
access types • DCL Concepts, 8-7 
commands for setting • DCL Concepts, 8-7 
for a disk volume • DCL Concepts, 8-7 
for a tape volume • DCL Concepts, 8-7 
when initializing a volume • DCL Concepts, 8-7 
Volume RT-11 • Files and Devices, 3-12 
Volume set 

adding to • Files and Devices, 3-11 
adding volumes • Files and Devices, 3-11 
creating • Files and Devices, 3-9, 3-10 
defining • Files and Devices, 3-10 
definition • Using VMS, 2-9; DCL Concepts, 3-5 
disk • Using VMS, 2-9; Files and Devices, 3-9; 
DCL Concepts, 3-5 
add volume • Files and Devices, 3-11 
mounting • Files and Devices, 3-8 
dismounting • DCL Dictionary, DCL1-172 
initializing • Files and Devices, 3-9 
list file • Files and Devices, A-3 
loosely coupled • Files and Devices, A-3 
magnetic tape 

automatic volume switching • Files and 
Devices, 3-17 

continuation volumes • Files and Devices, 
3-17 

creating • Files and Devices, 3-16 
mounting • Files and Devices, 3-15 
maximum number in set • Files and Devices, 3-11 
mounting • Files and Devices, 3-6, 3-8 
See also MOUNT command 
naming • Files and Devices, 3-9, 3-10 
privileges • Files and Devices, 3-9 
processing continuation volumes • Files and 
Devices, 3-15 

tape • Using VMS, 2-9; DCL Concepts, 3-5 


w 


WAIT command • DCL Dictionary, DCL2-397 to 
DCL2-398 

synchronizing command procedures • Command 
Procedures, 8-10 
Wait state 

delaying command processing • DCL Dictionary, 
DCL2-397 

inducing to synchronize process with batch job • 
DCL Dictionary, DCL2-387 
placing current process in • DCL Dictionary, 
DCL2-397 
Wakeup 

canceling request • DCL Dictionary, DCL1-56, 
DCL2-55 

scheduling with RUN command • DCL Dictionary, 
DCL2-55 
Wastebasket 

emptying • Mail, MAIL-39, MAIL-83 
recovering messages from • Mail, MAIL-39 
WHAT LINE command • EVE Ref, EVE-244 
White space 

finding in EVE • Using VMS, 8-19 
/WIDTH qualifier* VMS Intro, 6-16 
Width specifier 

with SET SCREEN • EDT Ref, EDT-190 
Wildcard character • VMS Intro, 2-3 

asterisk (*) • Using VMS, 2-14; DCL Concepts, 
3-17,3-19 to 3-20 

default pattern (EVE) • Text Processing, 1-30 
duplicating directory structure with • Using VMS, 

2- 25 

ellipsis (...) • Using VMS, 2-23 to 2-24; DCL 
Concepts, 3-10, 3-10 to 3-11 
hyphen (-) • Using VMS, 2-24 to 2-25; DCL 
Concepts, 3-10, 3-12 

in a file specification that contains logical names • 
DCL Concepts, 4-19 

in directory specifications • Using VMS, 2-8 
in EVE file name • Using VMS, 8-2 
in file name (EVE) • Text Processing, 1-2 
in file specifications containing logical names • 
Using VMS, 4-15 

in input file specifications • DCL Concepts, 3-17 
in output directory specifications • DCL Concepts, 

3- 20, 3-21 

in output file specifications • DCL Concepts, 3-19 
in search string • Using VMS, 8-18 
in search string (EVE) • Text Processing, 1-30 
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Wildcard character (Cont.) 

in UIC format output directory specifications • DCL 
Concepts, 3-21 

matching file names with (EVE) • Text Processing, 
1-52 

percent sign (%) • Using VMS, 2-15; DCL 
Concepts, 3-17 

to display logical names • DCL Concepts, 4-4 
used in directory specifications • Files and 
Devices, 4-4 

used with file • Files and Devices, 4-17 
used with magnetic tape • Files and Devices, 4-17 
WILDCARD FIND command • Using VMS, 8-18; 

EVE Ref, EVE-245 to EVE-249 
EVE editor • Text Processing, 1-30 
finding text with (EVE) • Text Processing, 1-26 
specifying direction of search (EVE) • Text 
Processing, 1-30 
Window 

definition • Using VMS, 8-2 
EVE • Text Processing, 1-2 
deleting • EVE Ref, EVE-42, EVE-95 
EVE commands for using • Using VMS, 8-35 
moving between • EVE Ref, EVE-94, EVE-98, 
EVE-104 

resizing • EVE Ref, EVE-46, EVE-229 
shifting • EVE Ref, EVE-218, EVE-219 
using multiple (EVE) • Text Processing, 1-55 
with the DCL command • EVE Ref, EVE-32 
Windows 

displaying count for open files • DCL Dictionary, 
DCL2-266 

displaying size for open files • DCL Dictionary, 
DCL2-266 

Word 

definition • Using VMS, 5-1 
WORD command • Using VMS, 8-55; EDT Ref, 
EDT-112 

See also Cursor movement 
Word dump* DCL Dictionary, DCL1-177 
WORD keypad function 

EDT • Text Processing, 2-11 
Work file • EVE Ref, 1-18 

assigning location of • Sort/Merge, SORT-72 
default number • Sort/Merge, SORT-35 
specifying number of • Sort/Merge, SORT-35 
VAXTPU • DCL Dictionary, DCL1-202 
Working set 
batch job 

defining default for • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 


Working set 

batch job (Cont.) 

defining extent for • DCL Dictionary, 
DCL1-260, DCL1-269, DCL2-208, 
DCL2-353, DCL2-383 

defining quota for • DCL Dictionary, 
DCL1-269, DCL2-208, DCL2-353, 
DCL2-383 
defining quota 

for batch job • DCL Dictionary, DCL2-61 
displaying 

limit for process • DCL Dictionary, DCL2-335 

quota for process • DCL Dictionary, 

DCL2-335 

modifying default size • DCL Dictionary, DCL2-244 
specifying default 

for detached process • DCL Dictionary, 
DCL2-61 

for subprocess • DCL Dictionary, DCL2-61 
specifying quotas • DCL Dictionary, DCL2-58 
Working set extent • Sort/Merge, SORT-7 

adjusting, for optimization • Sort/Merge, SORT-7 
Working set quota 

displaying • DCL Dictionary, DCL2-335 
/WORK qualifier • EVE Ref, 1-18 
/WORK_FILES qualifier • Sort/Merge, SORT-35, 
SORT-72 
WORLD category 

definition • DCL Concepts, 8-3 
World ownership category • Using VMS, 7-4 
WPS keypad • EVE Ref, EVE-183 
WPS keypad option 
EVE • Using VMS, 8-23 
EVE editor* Text Processing, 1-6 
online help for (EVE) • Text Processing, 1-36 
WPS Ruler key • EVE Ref, EVE-184 

for paragraph indent • EVE Ref, EVE-186 
for tab stops • EVE Ref, 1-42 
/WRAP qualifier* VMS Intro, 6-16 
Write 

record to file • DCL Dictionary, DCL2-399 
WRITE access 
See also Access 

for a device • DCL Concepts, 8-6 
for a directory • DCL Concepts, 8-8 
for a file • DCL Concepts, 8-9 
for a global section • DCL Concepts, 8-10 
for a logical name table • DCL Concepts, 8-10 
for a queue • DCL Concepts, 8-7 
for a volume • DCL Concepts, 8-7 
Write access category 

definition • Using VMS, 7-4 
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Write-back caching • Files and Devices, 3-14 
Write check 

with APPEND command • DCL Dictionary, 
DCL1-37 

with COPY command • DCL Dictionary, DCL1-80 
with INITIALIZE command* DCL Dictionary, 
DCL1-242 

WRITE command • VMS Intro, 5-5; Using VMS, 

6- 12, 6-13, 8-69; DCL Concepts, 5-1, 

7- 4; Command Procedures, 3-14, 6-5; 

DCL Dictionary, DCL2-399 to DCL2-401; EDT 
Ref, EDT-253 
See also CLOSE command 
See also Copying text 
See also OPEN command 
See also READ command 
EDT editor • Text Processing, 2-36 
updating records • Command Procedures, 6-7 
with symbols • Command Procedures, 6-5 
writing a string to a record • Command 
Procedures, 4-11 

WRITE FILE command • Using VMS, 8-24, 8-31, 

8- 34; EVE Ref, EVE-250 to EVE-251 

for buffer manipulation (EVE) • Text Processing, 
1-49 

writing buffer to a file using (EVE) • Text 
Processing, 1-54 
WRITE keyword 

SET BUFFER command (EVE) • Text Processing, 
1-50 

Write operation • Files and Devices, 4-14 

continuation volumes • Files and Devices, 5-5 
disk • Files and Devices, 4-15 
magnetic tape • Files and Devices, 4-15, 4-16, 
4-19 

ANSI-labeled • Files and Devices, 4-17 
/WRITE qualifier • EVE Ref, 1-19 


Y 


$$Year • DSR Ref, 3-18 



Zero creation date • Files and Devices, B-13 



XABDAT (extended attribute) block • Files and 
Devices, B-13 

CDT (creation date) field • Files and Devices, B-13 
EDT (expiration date) field • Files and Devices, 
B-13 

XLATE command • EDT Ref, EDT-332 
.XLOWER command • DSR Ref, 2-130, 6-2 
.XUPPER command • DSR Ref, 2-130, 6-2 
use of uppercase flag with • DSR Ref, 6-2 


Index-95 


















How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 


Electronic Orders 

To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Call 

800-DIGITAL 

809-754-7575 
800-267-6215 

International - 

Internal 1 - 


Contact 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 

Local Digital subsidiary 

Digital Equipment of Canada 
Attn: DECdirect Operations KA02/2 
P.O. Box 13000 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


1 For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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Preface 


This manual provides an overview of the VMS operating system and is 
designed to support general users in their daily computing tasks. 

Intended Audience 

This manual is intended for all general users. 

Document Structure 

This manual includes the following chapters: 

• Chapter 1—Introducing VMS and DCL 

• Chapter 2—Working with Files and Directories 

• Chapter 3—Working with Processes 

• Chapter 4—Using Logical Names 

• Chapter 5—Representing Data with Symbols 

• Chapter 6—Writing and Using Command Procedures 

• Chapter 7—Maintaining Accounts and System Security 

• Chapter 8—Editing Files with the EVE and EDT Editors 

• Chapter 9—Processing Files with DIGITAL Standard Runoff 

Two appendixes contain the following information: 

• ASCII character set 

• ASCII and DEC multinational character set tables 

• DEC Multinational Character Set 

• Expressions 
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Preface 


Conventions 


Convention 

Meaning 

IfiEEl 

In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 
a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 
key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 

CTRL/C 

A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 

$ SHOW TIME 

05-JUN-1988 11:55:22 

In examples, system output (what the system 
displays) is shown in black. User input (what 
you enter) is shown in red. 

$ TYPE MYFILE.DAT 

In examples, a vertical series of periods, or 
ellipsis, means either that not all the data that 
the system would display in response to a 
command is shown or that not all the data a 
user would enter is shown. 

input-file, . . . 

In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 

[logical-name] 

Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer 
to double quotation marks ("). The term 
apostrophe (') is used to refer to a single 
quotation mark. 
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1 


Introducing VMS and DCL 




1.1 




Your VAX computer operates under the control of the VMS (Virtual Memory 
System) operating system. VMS is an interactive system: while you are 
logged in to the computer, you and the system conduct a dialogue of 
command and response. You use DCL, the DIGITAL Command Language 
interpreter, to communicate with VMS. DCL provides you with over 200 
commands and functions to use in communicating with VMS to accomplish 
your computing tasks. 

This chapter describes basic interaction with the VMS operating system. In it, 
you will learn how to log in to the system, how to use DCL to communicate 
with the system, how to customize your computing environment, how to get 
online help, and how to use two system utilities that let you communicate 
with other users. 

Some of the topics discussed in this chapter require you to be familiar with 
your terminal. For information on setting up or using your terminal, see the 
owner's manual supplied with your terminal. 


Logging In to the System 

In order to interact with the VMS operating system, you must log in to 
an account. Logging in consists of identifying yourself to the system as 
an authorized user. Your system manager or whoever authorizes system 
use at your installation usually sets up accounts. This person provides you 
with your user name and password. Your user name is a unique name that 
identifies you to the system and distinguishes you from other users. In 
many cases, a user name is your first or last name. Your password is for 
your protection. If you maintain its secrecy, other users cannot use system 
resources under your user name. 

Use the following procedure to log in to the system: 

1 Make sure your terminal is plugged in and the power is turned on. 

2 Press RETURN to signal the system that you want to log in. (You may 
need to press RETURN several times.) The system responds by displaying 
a prompt for your user name. 

3 Enter your user name and press RETURN. The system displays your user 
name on the screen as you type it. (You have about 30 seconds to do this, 
otherwise the system "times out" and you must start the login procedure 
again.) After you enter your user name and press RETURN, the system 
prompts you for your password. 

4 Enter your password and press RETURN. The system does not display 
your password as you type it; this preserves the secrecy of your password. 
The password you enter is compared with the encrypted password stored 
in a system file called the User Authorization File (UAF). (See Section 7.1 
for more information about the UAF file.) 
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If you make a mistake entering your user name or password, or your 
password has expired, the system displays the message "User authorization 
failure," and you are not logged in. This message means that you made a 
typing mistake when entering your user name or password, or that your 
user name or password is incorrect. If you make a mistake entering your 
user name or password, press RETURN and try again. If your password has 
expired or you have any other problems logging in, get help from the person 
who set up your account. 

Some accounts are set up to require two passwords. If you see a second 
password prompt, enter the second password required to access that account. 

If none of these prompts ($, Password:, or Username:) appears when you 
press RETURN, a system password may be required to log in to your system. 
If you know the system password, type it and press RETURN. If you do not 
know it, see the person in charge of your system. 

If your login is successful, a dollar sign symbol ($) is displayed in the 
left margin of your terminal. This dollar sign is a prompt that VMS uses 
to indicate you are at DIGITAL Command Language (DCL) level and can 
begin entering DCL commands. When you log in to the system and work 
interactively with DCL, you are at command level 0. When you execute a 
program interactively, you are placed at command level 1; when the program 
completes execution, you are returned to command level 0. 

The following example shows a successful login: 

I RET | 

Username: CASEY I ret| 

Password: |ret| 

Welcome to VAX/VMS version 5.0 on node MARS 
Last interactive login on Friday, 31-DEC-1988 08:41 
Last non-interactive login on Thursday, 30-DEC-1988 11:05 

$ 

If your account was set up by someone else, immediately change your 
password after you log in for the first time. You should also change your 
password frequently to ensure system security. To change your password, 
enter the DCL command SET PASSWORD. Enter your old password at 
the first prompt and press RETURN. Enter your new password at the next 
prompt and press RETURN. Finally, enter your new password again and 
press RETURN to confirm your choice. The following example shows what 
you see: 

$ SET PASSWORD 
Old password: 

New password: 

Verification: 

(If you are managing your own system, see the Guide to Setting Up a VMS 
System for instructions on setting up a user account and establishing a 
password.) 

Each time you log in, the system automatically executes up to two login 
command procedures. A command procedure is a file that contains a list 
of DCL commands. When a command procedure is executed, the DCL 
interpreter reads the file and executes the commands it contains. 

If your system manager has set up a system login command procedure, it 
is executed when you log in. This command procedure allows your system 
manager to ensure that certain commands are always executed when you and 
other users on your system log in. 
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After executing the system login command procedure, the system executes 
your personal login command procedure, if one exists. Your personal login 
command procedure allows you to customize your computing environment. 
The commands contained in it are executed every time you log in. The person 
who set up your account may have placed a login command procedure in 
your top level directory. (Unless your account has been specially modified to 
do otherwise, the system automatically places you in your top level directory 
when you log in.) If a login command procedure is not there, you can create 
one yourself, name it LOGIN.COM, and place it in your top level directory 
unless your system manager tells you otherwise. DCL and DCL commands 
are discussed in Section 1.2. Directories, including your top level directory, 
are discussed in Chapter 2. A sample personal login command procedure is 
described in Section 6.3. 

When you log in, an environment is created from which you can enter 
commands. This environment is called your process. The system obtains the 
characteristics that are unique to your process from the user authorization file 
(UAF). The UAF lists those users permitted to access the system and defines 
the characteristics for each user's process. The system manager usually 
maintains the UAF. See Chapter 3 for more information about processes. 


1.1.1 Alternative Login Procedures 

The standard login procedure described in the preceding section may not fit 
your needs if you must log in to a terminal assigned to a specific account, 
access a system other than your own, or dial in to your system by telephone. 
The following sections describe these procedures. 


1.1.1.1 Automatic Login 

You may need to log in to a terminal that is assigned to a particular account. 
This procedure, called automatic login, permits you to log in without 
specifying a user name. To log in, turn on the terminal and press the 
RETURN key. Either the DCL or password prompt appears. If the DCL 
prompt appears, you are logged in. If the password prompt appears, type the 
password of the account associated with the terminal and press RETURN. 
(The password is not displayed on the screen.) If your login is successful, you 
see the DCL dollar sign prompt that VMS uses to indicate you are at DCL 
command level and can begin entering commands. 


1.1.1.2 Logging In over the Network 

Your system may be part of a DECnet-VAX network. VMS systems linked 
together in a DECnet network are able to communicate with each other and 
share information and resources. Each system in the network is called a 
network node and is identified by a unique node name and address. When 
you are logged in to a network node, you can communicate with every other 
node in the network. The node at which you are logged in is called the local 
node; the other nodes on the network are called remote nodes. 

If you have access to an account on a remote node, you can log in to that 
account from your local node and use the facilities of that remote node while 
remaining physically connected to your local node. 

The following example shows how to access a remote node on the network 
using the DCL command SET HOST. HUBBUB is the name of the remote 
node. 

$ SET HOST HUBBUB 
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You can then log in to your account on the remote node using the remote 
node's login procedure. When you use the SET HOST command to log in 
to a remote node, you can perform any operation on the remote node as 
though it were your local node. Note that the remote node need not be a 
VMS system. If the network link cannot be established, you receive an error 
message. 

If you want to abort the login procedure, enter CTRL/Z at the user name or 
password prompt or enter CTRL/Y twice. The host system should respond 
with the question, "Are you repeating A Y to abort the remote session?" 
Answering Y (uppercase or lowercase) aborts the remote session. 

You can terminate a remote session in two ways: 

• Use the remote system's logout procedure (for example, on a VMS 
system, use the LOGOUT command). 

• Press CTRL/Y twice to obtain the host system's prompt that asks whether 
you want to abort the remote session. Answer Y if you want to abort the 
remote session. This method works regardless of the system running on 
the remote node. 

When you terminate a remote session, the message "%REM-S-END, control 
returned to node __NODENAME::" is displayed, and you are returned to the 
system from which you made the remote node connection. 

If the DECnet network has made intermediate connections for you and one 
of the intermediate systems goes down, DECnet either attempts to reroute 
the connection or waits a few seconds to determine whether the system will 
recover. If DECnet is able to recover the connection, the interruption may 
be so brief that you do not notice it, or it may last as long as 60 seconds. If 
DECnet cannot recover the connection, the remote session is terminated and 
the message "Path lost to partner" may be displayed. 

See the VMS DCL Dictionary for more information about the DCL command 
SET HOST. For more information about networking and DECnet, see the 
Guide to DECnet-VAX Networking. 


1.1.1.3 Dialing In 

Dialing in allows you to communicate with your system by telephone. To 

dial in to your system, you need the following items: 

• Modem (or data set)—A modem is a piece of hardware that is 
independent of the VMS system. The user's manual that comes with 
the modem should describe how to connect the modem to a telephone 
line and a terminal. 

• Terminal—You cannot dial in unless the transmission speed (baud rate) 
of the terminal agrees with the baud rate of the modem and the modem 
terminal characteristic is set. To set the baud rate for VT200- and VT300- 
series terminals, select the "Comm" category in the Set-Up Directory. To 
set the baud rate for a VT100 series terminal, you must be in SET-UP 

B. To enter the Set-Up Directory, press the SET-UP key. Press the key 
labeled A/B to toggle to SET-UP B. 

To set the modem terminal characteristic, use the DCL command 
SET TERMINAL/MODEM. If your terminal has the modem terminal 
characteristic set (the DCL command SHOW TERMINAL lists the terminal 
characteristics set for your terminal), typing the SET 
TERMINAL/NOMODEM command causes the system to log you out. 
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See your terminal's installation manual for information on using the 
Set-Up Directory to set the baud rate and other terminal characteristics. 

• Manual login account—If your account is set up for automatic login, you 
cannot dial in to it. Either change the account to a manual login account 
(one where you must type your user name) or use a different account. 

• Telephone number for the system—To dial in, you must know the 
telephone number for your system. Get the telephone number from your 
system manager. 

Once the terminal is receiving the signal through the telephone line, 
follow the conventions your site has instituted for remote login. When 
communication is established, your system should respond with the DCL 
dollar sign prompt. 

If you are managing your own system, you can ensure system security by 
disallowing dialup accounts with null passwords. 


1 . 1.2 


Logging Out of the System 


When you finish using the system, always log out. This prevents 
unauthorized users from accessing your account and the system at large. 

It is also a wise use of system resources: the resources you no longer need 
are freed for use by others. 

To log out, enter the LOGOUT command, which can be abbreviated as LO. 
You see a display confirming that you are logged out of the system that looks 
similar to the following: 


$ LOGOUT 

HARRIS logged out at 31-DEC-1988 12:42:48.12 

You can log out of the system only when you are at the DCL prompt. You 
cannot enter the LOGOUT command while you are compiling or executing 
a program, using an editor (such as EDT or EVE), or running a utility (such 
as MAIL). First you must exit the program, editor, or utility and receive the 
DCL prompt. It is possible to exit by entering CTRL/Y, but this is not always 
advisable. See Section 1.3.2.2 for more information about using CTRL/Y. 

To find out how much time you spent at the terminal (elapsed time), how 
much computer time you used (charged CPU time), and other accounting 
information, include the /FULL qualifier to the LOGOUT command as 
follows: 


$ LOGOUT/FULL 

SIMPSON logged out at 31-DEC-1988 12:42:48.12 


Accounting information: 

Buffered I/O count: 8005 
Direct I/O count: 504 
Page faults: 1476 
Charged CPU time:0 00:00:50.01 


Peak working set size: 212 
Peak virtual size: 770 
Mounted volumes: 0 
Elapsed time:0 02:27:43.06 


If you are logging out from a dialup terminal, enter the LOGOUT command 
with the /HANGUP qualifier. This command causes the system to break the 
connection to the dialup line after you log out. 
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1.2 Using the DIGITAL Command Language 

The DIGITAL Command Language (DCL) is the language you use to 
communicate with the VMS operating system. DCL commands let you 
do the following: 

• Get information about the system 

• Work with files 

• Work with disks, magnetic tapes, and other devices 

• Modify your work environment 

• Develop and execute programs 

• Provide security and ensure that resources are used efficiently 

DCL commands are usually verbs that describe what you want the system to 
do. In response to the DCL dollar sign ($) prompt, you enter a command (in 
upper- or lowercase). The following example shows how to enter the DCL 
command SHOW TIME: 

$ SHOW TIME OH] 

The system responds by displaying the current date and time and returns the 
DCL prompt to indicate it is ready to accept another command: 

31-DEC-1988 15:41:43 

$ 

You can use DCL in the following two modes: 

• Interactive—In interactive mode, you enter commands from your 
terminal. One command has to finish executing before you can enter 
another. 

• Batch—In batch mode, the system creates another process to execute 
commands on your behalf. Batch jobs and network processes use DCL 
in batch mode. A process is an environment created by the system that 
makes it possible for you to work with the system. A batch job is a 
command procedure or program that is submitted to the operating system 
for execution as a separate user process. After you submit the command 
procedure for batch execution, you can continue to use your terminal 
interactively. (See Chapter 3 for more information about processes and 
batch jobs.) 

When you type a command and press RETURN, it is read and translated 
by the DCL interpreter. The way the command interpreter responds to 
a command is determined by the type of command entered. The three 
types of commands are as follows: 

Built-in commands—These commands, listed in Table 1-1, are 
built into the DCL interpreter. DCL executes a built-in command 
internally. 

Commands that invoke programs—DCL calls another program 
to execute the command rather than executing it internally. The 
program invoked to execute a command is referred to as a command 
image. This command image can be either an interactive program 
like MAIL or a noninteractive program like COPY. Parameter and 
qualifier information (which modify the command) are passed to the 
program. Most commands not listed in Table 1-1 are in this category. 
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Foreign commands—A symbol that executes an image is referred 
to as a foreign command. A foreign command executes an image 
whose name is not recognized by the command interpreter as a DCL 
command. The following example defines the symbol FUN as a 
foreign command. (No DCL command FUN exists.) 

$ FUN := $DISK1:[ROY.PROGRAMS]GAMES.EXE 

The request to execute the image GAMES.EXE is implied in the 
symbol definition by the presence of the dollar sign. (File names 
with a file type EXE are always executable images.) Once you equate 
the symbol FUN to the file specification shown, you can execute the 
image GAMES.EXE by typing FUN. 

See Chapter 5 and the VMS DCL Concepts Manual for information 
about defining symbols. See Chapter 3 for a description of images. 
Chapter 2 describes file names, file types, and file specifications. 


Table 1-1 Built-In Commands 


9 9 • / • 

ALLOCATE 

ASSIGN 

ATTACH 

CALL 

CANCEL 

CLOSE 

CONNECT 

CONTINUE 

CREATE/LOGICAI_NAME_TABLE 

DEALLOCATE 

DEASSIGN 

DEBUG 

DECK 

DEFINE 

DEFINE/KEY 

DELETE/KEY 

DELETE/SYMBOL 

DEPOSIT 

DISCONNECT 

ENDSUBROUTINE 

EOD 

EXAMINE 

EXIT 

GOSUB 

GOTO 

IF 

INQUIRE 

ON 

OPEN 

READ 

RECALL 

RETURN 

SET CONTROL 

SET DEFAULT 

SET KEY 

SET ON 

SET OUTPUT_RATE 

SET PROMPT 

SET PROTECTION/DEFAULT 

SET UIC 

SET VERIFY 

SHOW DEFAULT 

SHOW KEY 

SHOW PROTECTION 

SHOW QUOTA 

SHOW STATUS 

SHOW SYMBOL 

SHOW TIME 

SHOW TRANSLATION 

SPAWN 

STOP 

SUBROUTINE 

WAIT 


WRITE 


1.2.1 DCL Command HELP 

You can obtain online documentation for any DCL command by invoking the 
HELP facility. To use the HELP facility in its simplest form, enter the DCL 
command HELP. HELP displays a list of topics and the Topic? prompt. If 
you want to see information on one of the topics, type the topic name after 
the prompt. The system displays information on that topic. (Command and 
topic names can be abbreviated.) 
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If the topic has subtopics, HELP lists the subtopics and displays the Subtopic? 
prompt. If you want information on one of the subtopics, type the name after 
the prompt. If you want information on another topic, press RETURN. You 
can ask for information on another topic when HELP displays the Topic? 
prompt. If you want to exit the HELP facility, press RETURN again to return 
to DCL level. At any time, press CTRL/Z to exit. 

If you know the command you need information about, type HELP and the 
command name. 

If you need help but do not know what command or system topic to specify, 
enter the command HELP with the word HINTS as a parameter. Each task 
name listed in the HINTS text is associated with a list of related command 
names and system information topics. 

Following is a sample HELP display for the DCL command SHOW USERS: 

$ HELP SHOW USERS 
SHOW 
USERS 

Displays the terminal name, username, and process 
identification code (PID) of either specific interactive 
users or all interactive users on the sytem. 

Format: 

SHOW USERS [username] 

Additional information available: 

Parameters Command_Qualifiers 

/OUTPUT 

Examples 

SHOW USERS Subtopic? 

You can also obtain help while you are using an interactive utility. Utilities 
are programs that are invoked with DCL commands. To get help while 
you are using an interactive utility, type HELP at the utility prompt (and 
press RETURN) just as you would at DCL level. See Section 1.4 for more 
information about VMS utilities. 


1.2.2 The DCL Command Line 

DCL, like any language, has its own vocabulary and usage rules. The 
vocabulary consists of commands, parameters, and qualifiers, which are 
strung together in a way that DCL can interpret. The way in which the parts 
of a command line are put together is referred to as the command line syntax. 
DCL command line syntax follows the following general format shown. 
(Items in square brackets [ ] are optional and may not be required by a specific 
command.) 

[$] [label:] command [/qualifier[=value]...] [parameter[/qualifier...]] 
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The DCL command line can contain the following components: 

The dollar sign is the DCL prompt. When you work 
interactively with DCL, DCL displays the prompt when it is 
ready to accept a command. When you write a command 
procedure, you must type the dollar sign at the beginning of 
each line. 

Identifies a line in a command procedure. Use labels 
only within command procedures, which are described in 
Chapter 6. 

Specifies the name of the command. 

Specifies what the command acts upon. You must position 
parameters in a specified order within the command. The DCL 
command descriptions in the VMS DCL Dictionary describe 
what parameter values are allowed for each command and 
where they must be placed. Examples of parameter values 
include file specifications, queue names, and logical names. 

Modifies the action taken by the command. Some qualifiers 
can modify parameters. Some can accept values. The DCL 
command descriptions in the VMS DCL Dictionary indicate 
whether a specific qualifier can accept a value and what kind 
of value is acceptable. 

Modifies a qualifier and is often preceded by an equal sign. 

A value can be a file specification, a character string, a 
number, or a DCL keyword. A keyword is a word reserved 
for use in certain specified syntax formats. You must use 
keywords exactly as listed in the description of the particular 
DCL command you want to specify. For example, SYSTEM, 
OWNER, GROUP, and WORLD are DCL keywords. A DCL 
keyword can also have a value. 

Following is an example of a DCL command line: 

$ PRINT/C0PIES=5 LAUNDRY.LIS IretI 

In the previous example, the elements are as follows: 

• $ is the DCL prompt. 

• PRINT is a command. 

• /COPIES is a qualifier that modifies the command. 

• 5 is a value that modifies the qualifier. 

• LAUNDRY.LIS is a parameter (in this case the parameter is a file 
specification). 

In some cases (such as DELETE/ENTRY or SHOW QUEUE), a command 
is coupled with a parameter or qualifier. In these cases, the command and 
parameter or qualifier are used as a pair and cannot be separated. If you 
specify additional parameters or qualifiers, they must follow the command 
pair. 

The following example shows a command pair that contains a command 
(SHOW) and a parameter (QUEUE). The additional parameter LN03—PRINT, 
which specifies the queue name whose jobs you want displayed, is specified 
after the command pair. 


$ 


Label 

Command 

Parameter 


Qualifier 


Value 
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$ SHOW QUEUE LN03.PRINT 

Observe the following rules when entering DCL commands: 

• You can use any combination of uppercase and lowercase letters. The 
DCL interpreter translates lowercase letters to uppercase. Upper- and 
lowercase characters in parameter and parameter qualifier values are 
equivalent unless enclosed in quotation marks. 

• Separate the command name from the first parameter with at least one 
blank space. Separate each additional parameter from the previous 
parameter with at least one blank space. Begin each qualifier with a slash 
(/); the slash serves as a separator and need not be preceded by blank 
spaces or tabs. 

• You may need more than one line on your terminal screen to type 
a command line. Continue the command line onto the next line by 
terminating it with a hyphen and pressing RETURN. The system responds 
to this combination of a hyphen and RETURN with an underscore (_) 
followed by the dollar sign prompt; you continue typing the command 
line after this prompt. (A single command line cannot exceed 256 
characters.) A line beginning with an underscore means that the system 
is waiting for your response, as shown in the following example: 

$ COPY/LOG FORMAT.TXT,FIGURE.TXT,ART_WORK.TXT - 
_$ SAVE.TXT 

Note that you must include the appropriate spaces between command 
names, parameters, and so on. Pressing RETURN after the hyphen does 
not add a space. 

• A command line can contain a maximum of 128 elements (for example, 
a file specification or qualifier). Each element in a command must not 
exceed 255 characters. The entire command must not exceed 1024 
characters after all symbols and lexical functions are converted to their 
values. (You use symbols, described in Chapter 5, to pass information 
to the system in an abbreviated manner. A lexical function, described in 
Chapter 6, obtains information from the system, including information 
about system processes, batch and print queues, and user processes, and 
then substitutes the result of the operation for itself.) 

• You can abbreviate any command name by typing only the first four 
characters. You can abbreviate a command name to fewer than four 
characters as long as the abbreviated name remains unique among all 
DCL command names. 

For example, the following commands are equivalent: 

$ PR/C=2 FORMAL_ART.TXT 
$ PRINT/C0PIES=2 FORMAL_ART.TXT 

In interactive mode, you will work faster if you abbreviate. Do not 
abbreviate commands in command procedures because your command 
procedure will be difficult to read. Also, the abbreviations might not be 
valid if new DCL commands are added at a later date. 

Other rules governing the format of commands apply mainly to their use 

in command procedures. See Chapter 6 for more information about using 

commands in command procedures. 
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1.2.3 Prompting and System Defaults 

Some items must be entered on the command line. If you do not enter them, 
the system displays a prompt and asks you to supply the missing information. 
In the following example, the TYPE command expects a file specification. 
Because a file specification is a required parameter, if you do not enter one, 
the system requests it. A line beginning with an underscore (_) means the 
system is waiting for your response. 

$ TYPE 

.File: WATER.TXT 

When you are prompted for an optional parameter, press RETURN to omit it. 
At any prompt, you can enter one or more of the remaining parameters and 
any additional qualifiers. 

If you press CTRL/Z after a command prompt, DCL ignores the command 
and redisplays the DCL prompt. 

Some items need not be specified on the command line. These are called 
defaults. When DCL does something by default, it assumes that you want 
a command to use certain values or to take certain actions without your 
having to explicitly specify them. In general, the values and actions are those 
considered normal or expected by users. 

For example, if you do not specify the number of copies as a qualifier for 
the PRINT command, DCL uses the default value of 1. Unless you specify 
otherwise, DCL assumes that you have chosen the default. You can override 
this default behavior and print multiple copies of a file by specifying the 
following: 

$ PRINT/C0PIES=4 MYFILE.TXT 

DCL supplies default values in several areas, including command parameters 
and qualifiers. Parameter defaults are described in the following section; 
qualifier defaults are described in Section 1.2.5.2. 


1.2.4 Entering Parameters 

DCL supplies default values for some command parameters. The parameters 
accepted by a command as well as the specific command parameter defaults 
supplied by DCL are described in each command description in the VMS DCL 
Dictionary. The following rules apply when specifying parameters: 

• Square brackets ([]) indicate optional items. In the following example, 
you do not have to enter a file specification: 

DIRECTORY [file-spec] 

Anything not enclosed in square brackets is required. In the following 
example, you must enter a device name: 

SHOW PRINTER device-name 

• Place required parameters to the left of optional parameters. 

• Precede an output file parameter with an input file parameter. In the 
following example, the input file, LISTS.TXT, is copied to the output file, 
FORMAT.TXT: 

$ COPY LISTS.TXT FORMAT.TXT 
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The following example reverses the order of the parameters, copying the 
input file, FORMAT.TXT, to the output file, LISTS.TXT: 

$ COPY FORMAT.TXT LISTS.TXT 

• A parameter can be one item or a series of items. If you enter a series of 
items, separate them with commas (,) or plus signs ( + ). Any number of 
spaces or tab characters can precede or follow a comma or a plus sign. 
Note that some commands regard the plus sign as a concatenator, not as 
a separator. The parameter section of each DCL command description in 
the VMS DCL Dictionary describes how each command interprets commas 
and plus signs. 

The following command syntax line shows that you can optionally enter 
a list of files as the parameter: 

DELETE file-specf,...] 

The following example shows how to specify a list of parameters. Here, 
three files are copied to a fourth file. The three file specifications— 
PLUTO.TXT, SATURN.TXT, and EARTH.TXT—constitute the first 
parameter. PLANETS.TXT is the second parameter. 

$ COPY PLUTO.TXT,SATURN.TXT,EARTH.TXT PLANETS.TXT 


1.2.5 Entering Qualifiers 

The qualifiers accepted by a command are described in each command 
description in the VMS DCL Dictionary. The DCL command description 
also indicates whether a qualifier accepts a value and what kind of value is 
required. 

You can abbreviate any qualifier name by typing only the first four characters 
(not counting the slash). You can use fewer than four characters to abbreviate 
a qualifier name as long as the abbreviated name remains unique among all 
qualifier names for the same command. 

Although you are never required to specify a qualifier, commands have 
defaults automatically applied. You need to be aware of the defaults that 
apply for each qualifier. The following sections describe types of qualifiers 
and qualifier defaults. 


1.2.5.1 Types of Qualifiers 

The three types of qualifiers are as follows: 

• Command qualifiers—A command qualifier modifies a command. 

Although it is a good practice to place the qualifier after the command 
name (or, if you are specifying multiple qualifiers, after other command 
qualifiers that follow the command name), a command qualifier can 
appear anywhere in the command line. 

In the following example, /QUEUE is a command qualifier. The files 
SATURN.TXT and EARTH.TXT are queued to the LN03—PRINT queue. 

$ PRINT/QUEUE=LN03_PRINT SATURN.TXT,EARTH.TXT 
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• Positional qualifiers—A positional qualifier can modify commands or 
parameters and has different meanings depending on where you place 
it in the command string. If you place a positional qualifier after the 
command but before the first parameter, it affects the entire command 
string. If you place a positional qualifier after a parameter, it affects only 
that parameter. 

In the following example, the first PRINT command requests two copies 
of the files SPRING.SUM and FALL.SUM. The second PRINT command 
requests two copies of the file SPRING.SUM, but only one copy of 
FALL.SUM. 

$ PRINT/C0PIES=2 SPRING.SUM.FALL.SUM 
$ PRINT SPRING.SUM/C0PIES=2,FALL.SUM 

• Parameter qualifiers—A parameter qualifier can be used only with certain 
types of parameters, such as input and output files. 

For example, the BACKUP command accepts several parameter qualifiers 
that apply only to input and output file specifications. In the following 
example, the /CREATED and /BEFORE qualifiers, which can be specified 
only with input files, select specific input files for the backup operation. 
(For the purposes of this example, multiple copies of the file MYFILE.TXT 
exist. Only those versions that were created before December 31, 1988, 
are selected for the backup operation.) 

$ BACKUP MYFILE.TXT/CREATED/BEF0RE=31-DEC-1988 NEWFILE.TXT 


1.2.5.2 Qualifier Defaults 

When you omit a specific qualifier from the command line, the system 
responds with default behavior. For example, when you delete a file with 
the DELETE command, the system by default does not request confirmation 
of each delete operation. However, by specifying the DELETE/CONFIRM 
command, you can override that default behavior and request that you be 
prompted for confirmation before each file is deleted. 

You can specify qualifiers in several ways. The qualifier syntax required by 
a specific DCL command is given in the command descriptions in the VMS 
DCL Dictionary . The following paragraphs explain the syntax used to describe 
qualifiers and their defaults: 

• Qualifiers with positive and negative forms—These qualifiers have a 
value of true or false. You do not specify a value, but indicate a true 
value by simply naming the qualifier. Negate the qualifier by inserting 
the prefix NO. 

For example, the /CONFIRM qualifier can be expressed positively or 
negatively. If you omit the qualifier from the command line, the default 
action is /NOCONFIRM. The syntax for the /CONFIRM qualifier is given 
in a DCL command description as follows: 

/CONFIRM 

/NOCONFIRM (default) 

• Qualifiers that require values—If you use a qualifier that accepts a value, 
you must specify a value. If you omit the qualifier completely, the default 
value is applied. For example, if you use the /COPIES qualfier, you must 
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provide a numeric value. If you omit the /COPIES qualfier, the default 
is /COPIES=l. The syntax for the /COPIES qualifier is given in a DCL 
command description as follows: 

/COPIES=n 

If the qualifier accepts a list of values, you must enclose the values in 
parentheses and separate them with commas as follows: 

$ DELETE/ENTRY=(230,231) LN03_PRINT 

The command deletes jobs 230 and 231 from the queue LN03—PRINT. 

• Qualifiers that accept value and positive/negative combinations—Some 
qualifiers combine value and positive/negative characteristics so that the 
qualifier both accepts a value and allows you to negate the qualifier by 
inserting the prefix NO. For example, the SET TERMINAL command 
permits the following choices for the /PARITY qualifier: 

$ SET TERMINAL/PARITY=EVEN 
$ SET TERMINAL/PARITY=ODD 
$ SET TERMINAL/NOPARITY 

• Qualifiers that affect command execution only if specified—The qualifier 
has no corresponding default. For example, the /BY_OWNER qualifier 
does not affect the command if it is not specified. The syntax for the 
/BY_OWNER qualifier is given in a DCL command description as 
follows: 

/BY_OWNER 

• Qualifiers that override other qualifiers—Sometimes a command has a 
qualifier that is automatically applied as a default. Other qualifiers are 
available to override the default qualifier. 

For example, the /BRIEF qualifier is applied by default when you 
specify the DIRECTORY command. That is, the DIRECTORY command 
generates a listing that includes only the file name, file type, and version 
number of each file in the directory. You must specify the /FULL qualifier 
to generate a listing that includes the file name, file type, and version 
number as well as the number of blocks used, the date of the file's 
creation, the date the file was last backed up, and so on. 

Some commands contain conflicting qualifiers that cannot be specified in 
the same command line. If you use incompatible qualifiers, the command 
interpreter usually displays an error message. The command descriptions in 
the VMS DCL Dictionary indicate which qualifiers cannot be used together. 


1.2.6 Entering Dates and Times as Values 

Certain commands and qualifiers accept date and time values. You can 
specify these values in one of the following formats: 

• Absolute time 

• Delta time 

• Combination time (combines absolute and delta time formats) 
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1.2.6.1 Absolute Time 

Absolute time is a specific date or time of day. The format for an absolute 
time is as follows: 

[dd-mmm-yyyy][:][hh:mm:ss.cc] 

The fields are as follows: 


Field Meaning 

dd Day of the month; an integer in the range 1-31 

mmm Month; JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, 

NOV, or DEC 

yyyy Year; an integer 

hh Hour; an integer in the range 0-23 

mm Minute; an integer in the range 0-59 

ss Seconds; an integer in the range 0-59 

cc Hundredths of a second; an integer in the range 0-99 


You can truncate the date or the time on the right. However, if you are 
specifying both date and time, you must include a colon between them. The 
date must contain at least one hyphen. You can omit any of the fields within 
the date and time as long as you include the punctuation marks that separate 
the fields. A truncated or omitted date field defaults to the corresponding 
fields for the current date. A truncated or omitted time field defaults to zero. 
If you specify a past time in a command that expects the current or a future 
time, the current time is used. 


You can also specify an absolute time as one of the following keywords: 

Keyword 

Meaning 

TODAY 

TOMORROW 

YESTERDAY 

The current day, month, and year at 00:00:00.0 o'clock 

00:00:00.00 o'clock tomorrow 

00:00:00.00 o'clock yesterday 

Some examples of absolute time specifications follow: 

Time Specification 

Result 

31-DEC-1988:13 

31-DEC 

15:30 

31- 

31-::30 

1 P.M. on December 31, 1988 

Midnight at the beginning of December 31 this 
year 

3:30 P.M. today 

The 31st day of the current year and month at 
midnight 

12:30 A.M. on the 31st of this month 
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1.2.6.2 Delta Time 

Delta time is an offset (a time interval) from the current date and time to a 
time in the future. The general format of a delta time is as follows: 

[dddd-][hh:mm:ss.cc] 

The fields are as follows: 


Field Meaning 

dddd Number of days; an integer in the range 0-9999 

hh Number of hours; an integer in the range 0-23 

mm Number of minutes; an integer in the range 0-59 

ss Number of seconds; an integer in the range 0-59 

cc Number of hundredths of seconds; an integer in the range 0-99 

You can truncate a delta time on the right. If you specify the number of 
days, include a hyphen. You can omit fields within the time as long as you 
include the punctuation that separates the fields. If you omit the time field, 
the default is zero. 

Some examples of delta time specifications follow: 


Time Specification 

Result 

3- 

3 days from now (72 hours) 

3 

3 hours from now 

:30 

30 minutes from now 

3-:30 

3 days and 30 minutes from now 

15:30 

15 hours and 30 minutes from now 


1.2.6.3 Combination Time 

To combine absolute and delta time, specify an absolute time plus ( + ) or 
minus (-) a delta time. The format for combination time is as follows: 

"[absolute time][+delta time]" 
or 

[absolute time][-delta time] 

The variable fields and default fields for absolute and delta time values are 
the same as those described in the preceding sections. The delta time value 
must always be preceded by a plus or minus sign. (Note that the minus sign 
is the same keyboard key as the hyphen.) Whenever a plus sign precedes 
the delta time value, enclose the entire time specification in quotation marks. 
Also, you can omit the absolute time value. If you do, the delta time is offset 
from the current date and time. 

Some examples of combination time specifications follow: 
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Time Specification 

Result 

"+5" 

5 hours from now 

"+:5" 

5 minutes from now 

-:5 

Current time minus 5 minutes 

-1-00 

Current time minus 1 day. The minus sign (-) indicates a 
negative offset. The dash (-) separates the day from the 
time field. 


If a qualifier is described as a value that may be expressed as an absolute 
time, a delta time, or a combination of the two, you must specify a delta time 
as if it were part of a combination time. For example, to specify a delta time 
value of five minutes from the current time, use "+:5" (not "0-0:5"). 


Entering and Editing DCL Commands 

At the DCL level, you can use many individual keys and key combinations 
to change what you type, to recall commands, or to display information. 
Table 1-2 lists the keys that allow you to enter and edit DCL commands. 
Sections that follow describe these keys in greater detail. 

DCL also provides you with shortcuts that simplify the typing of commands 
and command lines. You can establish symbols to use in place of command 
names and entire command strings. You can define keys, which enable you 
to enter commands with fewer keystrokes. These shortcuts are described in 
Section 1.3.7 and Section 1.3.8. 

Table 1-2 Keys That Execute Terminal Functions 

Key 

Function 

Keys That Enter DCL Commands 

CTRL/Z and FI0 1 

RETURN 

Signals the end of the file for data entered from the terminal. CTRL/Z 
is displayed as "Exit." 

Sends the current line to the system for processing. (On some 
terminals, the RETURN key is labeled CR.) 

Before a terminal session, RETURN initiates a login sequence. 

Keys That Interrupt DCL Commands 

CTRL/C and F6 1 

CTRL/T 

During command entry, cancels command processing. CTRL/C is 
displayed as "Cancel." 

Momentarily interrupts terminal output to display a line of statistical 
information about the current process. This display includes your node 
and user name, the time, the name of the image you are running, and 
information about system resources used during your current terminal 
session. 


1 This key is available only on an LK201 keyboard. 
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Table 1-2 (Cont.) Keys That Execute Terminal Functions 


Key Function 


Keys That Interrupt DCL Commands 


CTRL/Y 

You can also use the CTRL/T key to determine whether the system 
is operating. CTRL/T does not return information if the system is 
temporarily unresponsive or if your terminal is set to NOBROADCAST. 
In order to use CTRL/T, SET CONTROL=T must be enabled either in 
the system login command procedure or by you, either interactively or 
in your login command procedure. 

Interrupts command processing. CTRL/Y is displayed as "Interrupt." 
You can disable CTRL/Y with the command SET NOCONTROL=Y. 

Under most conditions, CTRL/Y returns you to the DCL prompt. The 
program running is still active. You can enter any built-in command 
(described in Section 1.3.2) and then continue the program with the 
CONTINUE command. (Press CTRL/W to refresh the screen after you 
enter the CONTINUE command.) 


Keys That Recall Commands 


CTRL/B and Up arrow 

Down arrow 

Recalls up to 20 previously entered commands. 

Displays the next line in the recall buffer. 


Keys That Control Cursor Position 


<3 , DELETE 

Deletes the last character entered at the terminal. (On some terminals, 
the DELETE key is labeled RUBOUT.) The DELETE key also works 
when line editing is disabled. 

CTRL/A, F14 1 

Switches between overstrike and insert mode. The default mode (as 
set with the SET TERMINAL/LINE—EDITING command) is reset at the 
beginning of each line. 

CTRL/D and Left arrow 

CTRL/E 

CTRL/F and Right arrow 

CTRL/H, BACKSPACE, and F12 1 
CTRL/I and TAB 

Moves the cursor one character to the left. 

Moves the cursor to the end of the line. 

Moves the cursor one character to the right. 

Moves the cursor to the beginning of the line. 

Moves the cursor to the next tab stop on the terminal. The system 
provides tab stops at every eighth character position on a line. Tab 
settings are hardware terminal characteristics that, in general, you can 
modify. The TAB key also works when line editing is disabled. 

CTRL/J, LINEFEED, and F13 1 
CTRL/K 

CTRL/L 

Deletes the word to the left of the cursor. 

Advances the current line to the next vertical tab stop. 

Causes the cursor to go to the beginning of the next page. This use 
of this key is ignored when line editing is enabled. 

CTRL/R 

Repeats the current command line and leaves the cursor positioned 
where it was when you pressed CTRL/R. 

CTRL/U 

Cancels the current input line. 


^his key is available only on an LK201 keyboard 
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Table 1-2 (Cont.) Keys That Execute Terminal Functions 


Key 

Function 

Keys That Control Cursor Position 

CTRL/V 

Turns off some of the line editing function keys. For example, if you 
press CTRL/V followed by CTRL/D, a CTRL/D is generated instead of 
the cursor moving left one character. CTRL/D is a line terminator at 
DCL level. 


When combined with CTRL/V, characters that are not line terminators 
have no effect. Examples are CTRL/H and CTRL/J. However, certain 
control keys, such as CTRL/U, retain their line editing functions. 

CTRL/X 

Cancels the current line and deletes data in the type-ahead buffer. 

F7, F8, F9, F11 

Reserved for DIGITAL. 

Keys That Control Screen Display 

CTRL/O 

Alternately suspends and continues display of output to the terminal. 
CTRL/O is displayed as "Output off" and "Output on." 

CTRL/S 

Suspends terminal output until CTRL/Q is pressed. 

CTRL/Q 

Resumes terminal output suspended by CTRL/S. 

HOLD SCREEN’and NO SCROLL 2 

Suspends terminal output until the key is pressed again. 

1 This key is available only on an LK201 keyboard. 

2 This key is available only on a VT100 keyboard. 


1.3.1 Entering a DCL Command 

The RETURN key is recognized as a command line terminator. Once you 
type a command at the DCL prompt, press RETURN to terminate the line and 
send it to the DCL interpreter for execution. CTRL/Z is also recognized as a 
command line terminator. 

When you enter a command at the terminal or execute an image that results 
in an error, the system displays an error message. Also, the system sometimes 
generates messages when a command has completed successfully. For 
interactive users, messages are normally displayed on the terminal; for batch 
job users, messages are written to the batch job log file. 

Most system error messages have the following format: 

%FACILITY-L-IDENT, text 

The fields are as follows: 

• FACILITY is a mnemonic for the program issuing the message. 

• L is the first letter of the severity code; the severity level can be S 
(Success), I (Information), W (Warning), E (Error), or F (Fatal or severe 
error). 

• IDENT is an abbreviation of the text. 

• Text is an explanation of the error. 
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Suppress any component of the error message with the SET MESSAGE 
command. (See the VMS DCL Dictionary for the SET MESSAGE qualifiers you 
need to specify to suppress individual components of the error message.) 

A SET MESSAGE command remains in effect until you enter the SET 
MESSAGE command again or log out. The following command suppresses 
the abbreviation of the explanatory text of the message: 

$ SET MESSAGE/NOIDENTIFICATION 


1.3.2 Interrupting and Canceling a DCL Command 

After you enter a DCL command, you can temporarily interrupt its execution, 
run other commands, and then return to executing the command that was 
interrupted. To interrupt the execution of a command, use CTRL/T, CTRL/Y, 
or CTRL/C. These keys perform in different ways depending on the type of 
DCL command currently executing. 

As mentioned previously, there are built-in commands and command images. 
A built-in DCL command (listed in Table 1-1) is part of the command 
interpreter. A command image is a program that is called by the DCL 
interpreter. (For example, COPY is a command image.) 

A command image can be privileged or nonprivileged. The VMS operating 
system, the system manager, or you may install a command image as 
privileged. Privileged command images may vary from system to system. 
Your system manager can tell you which command images on your system 
are privileged. 

For more information on privileged command images, see the VMS Install 
Utility Manual. 


1.3.2.1 Using CTRL/T 

CTRL/T interrupts execution of the command, displays a line of statistical 
information about the current process (node name, process name, system 
time, currently running image, elapsed CPU time, page faults, direct and 
buffered I/O operations, and pages in physical memory), and resumes 
command execution. You can use CTRL/T to interrupt a built-in command, 
or a privileged or nonprivileged command image. The following example 
shows how pressing CTRL/T interrupts and then resumes the copy operation: 

$ COPY [JONES.MEMOS]TODAY.LIS URGENT.LIS 

[CTRL/T| 

SATURN::JONES 16:54:17 COPY CPU=00:00:00.54 PF=241 10=47 MEM=141 
$ 

In order to use CTRL/T, SET CONTROL=T must be enabled either in the 
system login command procedure or by you. You can enable CTRL/T 
in your login command procedure, or you can enable it interactively by 
entering SET CONTROL=T at DCL level. (To enable CTRL/T for the current 
session, you must enable it interactively.) Section 1.1 describes your personal 
login command procedure; Section 6.3 shows a sample personal command 
procedure. 
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1.3.2.2 Using CTRL/Y 

When you use CTRL/Y to interrupt a nonprivileged command image, the 
interrupted command is temporarily suspended and control returns to the 
DCL interpreter. You see the DCL prompt. To resume execution of the 
interrupted command, type CONTINUE. Only built-in commands can 
be entered after CTRL/Y and before CONTINUE without disturbing the 
interrupted command. Entering any other type of command effectively 
cancels the interrupted one. 

If you are interrupting a privileged command image, you can press CTRL/Y 
and enter the built-in commands SPAWN, ATTACH, and CONTINUE only, 
followed by any other command. Entering a command after CTRL/Y other 
than SPAWN, ATTACH, and CONTINUE effectively cancels the interrupted 
one. 

You can immediately terminate the privileged or nonprivileged command 
image that you interrupted with CTRL/Y by entering one of the following: 

• The STOP or EXIT commands. STOP suppresses any cleanup activities 
such as the display of error messages. EXIT executes any cleanup 
procedures before terminating. 

• A command that invokes another command image (that is, a nonbuilt- 
in command), which removes the interrupted command image from 
memory. 


1.3.2.3 Using CTRL/C 

CTRL/C works like CTRL/Y in many cases. CTRL/C interrupts the execution 
of a built-in command. Command images, however, can create different 
definitions for CTRL/C, in which case pressing CTRL/C does not necessarily 
interrupt the command and return you to DCL level. For example, the TYPE 
command (a command image) defines CTRL/C as "cancel." Pressing CTRL/C 
while typing a series of files to the terminal halts the display of the current 
file and begins the display of the next file in the series, but does not interrupt 
the command. 


1.3.3 Redirecting the Output of Commands 

Many commands allow you to specify the /OUTPUT qualifier to redirect 
output. The following example shows how the display produced by the DCL 
command DIRECTORY is redirected to a new text file named FULL.LIS in 
your default directory: 

$ DIRECTORY/FULL/OUTPUT=FULL.LIS 


1.3.4 Recalling Commands 

At DCL level, you can recall previously typed command lines and avoid the 
inconvenience of retyping long command lines. The recall buffer holds up 
to 20 previously entered commands. Once a command is displayed, you can 
reexecute or edit it. 

Each of the following lets you display the commands stored in the recall 
buffer: 

• CTRL/B 

• Up and down arrow keys 
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• RECALL command 

Pressing CTRL/B once recalls the previous command line. Pressing CTRL/B 
again recalls the line before the previous line, and so on to the last saved 
command line. 

Pressing the up and down arrow keys recalls the previous and successive 
command, respectively. Press the arrow keys repeatedly to move through the 
commands. 

To examine up to 20 previously typed command lines, type RECALL/ALL. 
Following is a sample display generated by typing RECALL/ALL: 

$ RECALL/ALL 

1 SET DEFAULT DISK2:[MARSHALL] 

2 EDIT ACCOUNTS.COM 

3 PURGE ACCOUNTS.COM 

4 DIRECTORY/FULL ACC0UNTS.COM 

5 COPY ACC0UNTS.COM [.ACCOUNTS]* 

6 SET DEFAULT [.ACCOUNTS] 

Having reviewed the available commands, you can recall a particular 
command line by typing RECALL and the number of the desired command. 
The following example shows how to recall the fourth command line stored 
in the recall buffer: 

$ RECALL 4 

After you press RETURN, the fourth command in the list is displayed at the 
DCL prompt. (The RECALL command itself is not placed in the buffer.) 

You can also follow RECALL with the first characters of the command line 
you want to display. RECALL scans the previous command lines (beginning 
with the most recent one) and returns the first command line that begins with 
the characters you typed. For example: 

$ RECALL E 

After you press RETURN, the following command line is displayed: 

$ EDIT ACC0UNTS.COM 

You can also perform command recall with CTRL/B and the up and down 
arrow keys. If you are running a utility or an application program that uses 
VMS screen management software, you can also use these keys to perform 
command recall. Line editing must be enabled. Some utilities that have this 
feature are MAIL, DEBUG, SHOW CLUSTER, the System Dump Analyzer 
(SDA), and the VAXTPU editor. 


.5 Editing a DCL Command 

Your terminal has a set of keys that you can use to edit a DCL command line. 
Command-line editing is most useful for modifying long command lines. You 
can edit command lines that contain typographical errors or command lines 
that you have recalled and want to modify. 

There are many types of terminals, each with its own operating 
characteristics. In general, they all have standard line editing keys. Line 
editing keys (keys that let you edit the DCL command line) allow you to 
control cursor position and are listed in Table 1-2. 
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For some of the line editing keys to work, the SET TERMINAL/ 

LINE ^EDITING command must be in effect. To see whether or not line 
editing is enabled, enter the SHOW TERMINAL command, which displays 
your terminal's current characteristics. Use the SET TERMINAL command 
to change any of these characteristics. See the VMS DCL Dictionary for a 
description of SET TERMINAL. 

For example, the following command line contains one mistake that can be 
corrected easily using the line editing keys: 

$ DILETE SCHEDULE.TXT;3 

If you are using an LK201 keyboard (VT200- and VT300-series terminals), 
press the F12 key. If you are using a VTlOO-series terminal, press the 
BACKSPACE key. Notice that the cursor moves to the beginning of the 
line. Press the right arrow key once to position the cursor over the "I" in 
"DILETE." Type the letter E and the typographical error is corrected. 

The preceding example assumes that the SET TERMINAL/OVERSTRIKE 
attribute is in effect, as it is by default. The OVERSTRIKE attribute allows 
you to replace the incorrect character by typing the correct character over it. 

To insert characters in the command line without simultaneously deleting 
others, change the OVERSTRIKE attribute to the INSERT attribute. While 
you are editing a command line, you can set the OVERSTRIKE or INSERT 
attributes temporarily by pressing F14 (or CTRL/A). Use the SET TERMINAL 
command to set either attribute for your current terminal session. 


1.3.6 Controlling Screen Display 

Your terminal has several keys that permit you to suspend and resume the 
display of output to the terminal screen. These keys—CTRL/O, CTRL/Q, 
and CTRL/S—are useful when a large file is scrolling on your screen and you 
want to stop the display temporarily. 

To suspend output to your terminal, press CTRL/S. To resume the output 
suspended by CTRL/S, press CTRL/Q. To toggle between suspending and 
resuming the output, type CTRL/O, which is alternatively displayed as 
"Output off" and "Output on." 

The VT200- and VT300-series terminal also have a HOLD SCREEN key 
that you can press to alternately hold and resume screen output. On VT100 
terminals, the NO SCROLL key performs this same function. 


1.3.7 Representing DCL Commands with Symbols 

When you specify parameters, multiple qualifiers, and values, one DCL 
command line can make for much typing. You can simplify your interaction 
with DCL and save time by establishing symbols to use in place of command 
names and entire command strings you type frequently. A symbol is a name 
that represents a numeric, character, or logical value. When you use a symbol 
in a DCL command line, DCL uses the value you assign to the symbol. By 
defining a symbol as a command line, you can execute the command by 
typing only the symbol name. 

The following example equates the symbol ME to the DCL command SHOW 
ENTRY: 

$ ME == "SHOW ENTRY" 
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After you equate a symbol to an expression (which can be a DCL command), 
the symbol assumes a new identity or value. In the previous example, the 
symbol ME assumes a new identity as the DCL command SHOW ENTRY. 
Once the two are equated, use the symbol ME in place of the SHOW ENTRY 
command as follows: 

$ ME 

Jobname Username Entry Blocks Status 


STAFF JONES 202 38 Printing 

On printer queue SYS$PRINT 

You can also equate long command strings to symbols. The following 
example equates the symbol LN03 with the command string shown: 

$ LN03 == "PRINT/QUEUE=HUBBUB_LN03A/N0BURST/N0FEED/N0TIFY" 

By defining a symbol interactively, you create a symbol that is in effect for the 
current session only. If you want that symbol to be in effect each time you 
log in, place the symbol definition in your login command procedure. See 
Chapter 5 for more information about defining symbols. See Section 1.1 and 
Section 6.3 for more information about creating a personal login command 
procedure. 


1.3.8 Defining Terminal Keys 

Key definitions let you customize your keyboard so you can enter DCL 
commands with fewer keystrokes. A key definition is a string of characters 
that you assign to a particular terminal key. When a key is defined, you can 
press it instead of typing the string of characters. A key definition usually 
contains all or part of a command line. When you press a defined key, the 
command is either displayed on your terminal or executed. 

Some definable keys are automatically enabled for definition (like keys 
PF1 through PF4 and keys FI 7 through F20 on VT200- and VT300- 
series terminals). However, before you can define other keys, including 
KPO (keypad 0) through KP9 and the keypad keys PERIOD, COMMA, 
MINUS, and ENTER, you must enable them for definition by entering either 
the SET TERMINAL/APPLICATION-KEYPAD or the SET TERMINAL 
/NONUMERIC command. For a complete list of definable keys and for more 
information on how to create key definitions, see the description of the DCL 
command DEFINE/KEY in the VMS DCL Dictionary. 

The following example shows how to equate the PF1 key to the PRINT 
command and the PF2 key to the qualifier /QUEUE=SATURN_LN03: 

$ DEFINE/KEY PF1 "PRINT" 

*/,DCL-I-DEFKEY, DEFAULT key PF1 has been defined 
$ DEFINE/KEY PF2 "/QUEUE=SATURN_LN03" 

•/.DCL-1-DEFKEY, DEFAULT key PF2 has been defined 

When you press the PF1 key and then the PF2 key, the words PRINT/ 
QUEUE=SATURN_LN03 are echoed and entered as if you had typed them. 
You need only supply the parameter, which is the file name of the file 
you want to print. When defining a command line with two or more keys, 
remember to include all the necessary spaces required in the command line 
syntax. 
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The informational message following the key definition indicates the key state 
for which the key is defined. Key states are described in Section 1.3.8.1. You 
can suppress the informational message using the /NOLOG qualifier of the 
DEFINE/KEY command. 

A key definition remains in effect until you redefine the key, enter the 
DELETE/KEY command for that key, or terminate the session. If you want 
to use a key definition each time you log in, place the key definition in 
your login command procedure. See Section 6.3 for more information about 
creating your personal login command procedure. 


1.3.8.1 Key States 

The same key can be assigned multiple definitions, as long as each definition 
is associated with a different state. A key state is a name you invent to remind 
you of the types of key definitions grouped under it. If you do not create any 
key states, all keys are defined in the DEFAULT state. 

Specify the /SET—STATE qualifier to the DEFINE/KEY command to change 
the key state temporarily (the key state remains in effect until you press a 
definable key or terminate the command line). Use the /IF—STATE qualifier 
to the DEFINE/KEY to define a key for the specified state. 

In the following example, the PF1 key in the DEFAULT state is defined to 
enter the PRINT command and to change the key state to PRINTERS. The 
MINUS key is defined in the PRINTERS state to enter the 
/QUEUE=LN03—PRINT qualifier. The COMMA is defined in the PRINTERS 
state to enter the /QUEUE=LINE—PRINT qualifer. (Remember to enter the 
DCL command SET TERMINAL/APPLICATION-KEYPAD to enable keypad 
key definitions.) The /TERMINATE qualifier places a carriage return after the 
text; when you press the key, the system attempts to execute the command 
line. 

$ DEFINE/KEY/SET_STATE=PRINTERS PF1 "PRINT" 

•/.DCL-I-DEFKEY, DEFAULT key PF1 has been defined 
$ DEFINE/KEY/TERMINATE/IF_STATE=PRINTERS MINUS "/QUEUE=LN03_PRINT" 
‘/.DCL-I-DEFKEY, PRINTERS key MINUS has been defined 
$ DEFINE/KEY/TERMINATE/IF_STATE=PRINTERS COMMA "/QUEUE=LINE_PRINT" 
•/.DCL-I-DEFKEY, PRINTERS key COMMA has been defined 

To change a key state permanently (until you log out or change the state 
again), specify the /LOCK and /SET-STATE qualifiers to the DEFINE/KEY 
command, or specify the /STATE qualifier to the SET KEY command. After 
permanently changing the key state, you can recall the DEFAULT key state. 
However, the system does not provide a mechanism that allows you to 
determine whether the DEFAULT state was the previous key state. 

Because you cannot determine the previous key state after permanently 
changing the key state, you may want to use the following steps to extend 
the duration of a temporary state: 

1 Use the /SET—STATE qualifier to the DEFINE/KEY command to change 
your key state temporarily. 

2 Each time you define a key for that temporary state, use the /SET— STATE 
qualifier to reset the temporary state. 


1-25 







Introducing VMS and DCL 

1.3 Entering and Editing DCL Commands 


1.3.8.2 Examining and Deleting Keys 

To examine the key definitions you have created, enter the SHOW KEY 
command. Specify the /DIRECTORY qualifier to display the states that you 
have defined as follows: 

$ SHOW KEY/DIRECTORY 

DEFAULT 

GOLD 

Specify the /ALL and /FULL qualifiers to list all the keys in the states 
specified by the /STATE qualifier. The following example shows that the PF1 
key has been defined to enter the DIRECTORY command. The PF2 key has 
been defined to enter the SET DEFAULT command and change the key state 
from DEFAULT to DIRECTORIES. 

$ SHOW KEY/ALL/FULL/STATE=DEFAULT 
DEFAULT keypad definitions: 

PF1 = "DIRECTORY" (echo.terminate,noerase,nolock) 

PF2 = "SET DEFAULT" (echo,noterminate,noerase,nolock,state=DIRECTORIES) 

To delete a particular key definition, enter the DELETE/KEY command, as 
shown in the following example: 

$ DELETE/KEY PF1 

*/,DCL-I-DELKEY, DEFAULT key PF1 has been deleted 

The following example shows how to delete all the keys defined in the GOLD 
state: 

$ DELETE/KEY/ALL/STATE=GOLD 

*/,DCL-I-DELKEY, GOLD key PF2 has been deleted 

•/.DCL-I-DELKEY, GOLD key PF3 has been deleted 


Utilities 

A utility is a program that provides a service. Utilities are invoked with 
DCL commands. Some utilities —interactive utilities —provide a special 
environment from which you can perform a specific set of tasks. You 
work interactively with these utilities by entering subcommands and other 
information in response to the utility's prompt. For example, MAIL is an 
interactive utility; it has its own prompt and subcommands. 

Other utilities are noninteractive. When you invoke a noninteractive utility, 
it occupies your terminal and executes a task. When the task is complete, 
you are returned to DCL level and your terminal is once again available. 

The SORT/MERGE and the LIBRARIAN utilities are two examples of 
noninteractive utilities. 

Some utilities, both interactive and noninteractive, prompt you for a file 
name. When you are using such a utility (for example, BACKUP, MESSAGE, 
PATCH, and SORT/MERGE), you can add qualifiers to the DCL command 
line to tailor the utility to your specific needs, as shown in the following 
example: 

$ BACKUP/RECORD/IMAGE/LOG [Ml 
_From: 

To exit from a utility and return to DCL level, type EXIT (and press RETURN) 
or press CTRL/Z in response to the utility prompt. 
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The following sections describe the interactive VMS Mail Utility, the VMS 
Phone Utility, and the Sort/Merge Utility. 


1.4.1 Using the Mail Utility 

The interactive VMS Mail Utility (MAIL) allows you to send messages to 
and receive messages from other users on your system or on any other VAX 
computer that is connected to your system by means of DECnet-VAX. You 
can also file, forward, delete, reply to, and print messages that you have 
received. 

To invoke the Mail Utility, enter the DCL command MAIL at the DCL 
prompt. The MAIL prompt appears, signaling that the utility is ready to 
accept subcommands as follows: 

$ MAIL 
MAIL> 

For more information about MAIL commands and qualifiers, see the VMS 
Mail Utility Manual or type HELP at the MAIL prompt. 

To exit from MAIL, enter the MAIL command EXIT or press CTRL/Z. Note, 
however, that if you are entering the text of a message, CTRL/Z sends the 
message. If you wish to cancel the send operation without exiting from 
MAIL, press CTRL/C. 


1.4.1.1 Creating a Mail Subdirectory 

When you receive mail messages, they are usually written to files named 
MAIL$xxxxxxxxxx.MAI located in your top level directory. To avoid the 
display of these MAI files in your top level directory, use the MAIL command 
SET MAIL—DIRECTORY, which creates a mail subdirectory and moves all 
your MAI files to that subdirectory. (The MAIL command SHOW 
MAIL—DIRECTORY displays the name of the subdirectory that contains all 
your MAI files.) To move the MAI files from a subdirectory back to your top 
level directory, use the SET NOMAIL—DIRECTORY command. 


1.4.1.2 Sending Mail 

You can create and send a mail message interactively to one user or many 
users with the Mail Utility. Also, you can send a file to other users from 
within MAIL or from DCL level. 

Sending a Message 

To send a mail message to any user on your system, invoke the Mail Utility 
and specify the MAIL command SEND. MAIL prompts you for the name of 
the user receiving the message, the subject of the message (optional), and the 
text of the message (optional). The following example sends a message to 
THOMPSON: 

MAIL> SEND 

To: THOMPSON 

Subj: Meeting on January 9 

Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 

I have some new ideas for the Hubbub Cola account. Let me know when 
you're available to talk about them. 

--Jeff 
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Press CTRL/Z to send the message. If you decide not to send the message, 
press CTRL/C. Doing so cancels the send operation without exiting from 
MAIL. 

You can send the same message to several users. To do so, separate their user 
names with commas, as shown in the following example: 


MAIL> SEND 

To: THOMPSON,JONES,BARNEY 

Subj: Meeting on January 9 


If your computer system is part of a network, you can send mail to any other 
user on the network. If you are sending mail to someone not on your node, 
you must enter their node name and user name at the To: prompt. (See 
Section 1.1.1.2 for more information about nodes.) You can address the mail 
message to the intended recipient on the remote node using the following 
format: 

nodename: :username 


The following example shows how to send a message to user HIGGINS on 
node CHEETA: 


MAIL> SEND 

To: CHEETA::HIGGINS 


MAIL will notify you if the network connection to the remote node is not 
available. 


You may want to use a VMS text editor to compose your message before 
you send it interactively. (A text editor allows you to enter text from the 
keyboard and use editing commands to modify that text. See Chapter 8 for 
a description of the EVE and EDT text editors.) To do so, specify the /EDIT 
qualifier with the SEND command as shown in the following example: 


MAIL> SEND/EDIT 


After you respond to the To: and Subj: prompts, MAIL invokes the text 
editor. By default, MAIL invokes the EDT editor. (Section 1.4.1.8 describes 
how to change the default editor.) 


If you see an asterisk (*) after you enter the subject line and press RETURN, 
press the C key to enter the screen editor. To send the message, exit from 
the editor by pressing CTRL/Z and entering the EXIT command; to cancel 
the send operation, exit from the editor by pressing CTRL/Z and entering the 
QUIT command. 


You can also use the /EDIT qualifier with the REPLY and FORWARD 
commands. By specifying /EDIT when you invoke MAIL, you can use 
the editor for send, reply, and forward operations during the ensuing mail 
session. 


Sending a File 

You can send a file to other users from within MAIL or from DCL level. The 
following example invokes MAIL and uses the MAIL command SEND to 
send a file: 

$ MAIL 

MAIL> SEND MEMO.TXT 
To: EDGELL 
Subj: Another memo 



1-28 






Introducing VMS and DCL 


1.4 Utilities 



To send the file, press RETURN; to cancel the send operation, press CTRL/C 
or CTRL/Y. CTRL/C keeps you within the Mail Utility; CTRL/Y returns you 
to DCL level. 

When you send a file from DCL level, MAIL is invoked, but you do not enter 
an interactive session, nor do you see the MAIL prompt. When the file is 
sent, you are automatically returned to DCL level. When you are sending 
a file in this way, the argument to the (optional) /SUBJECT qualifier must 
be enclosed in quotation marks if it contains any spaces or nonalphanumeric 
characters, as shown in the following example: 

$ MAIL/SUBJECT="Another memo" MEMO.TXT CHEETA::EDGELL 

To send the file, press RETURN; to cancel the send operation, press CTRL/C. 

Sending a Message to a Distribution List 

If you need to send one message to many users, you can create a file—called 
a distribution list —that contains a list of users. You then specify that file 
name rather than the individual user names when you send the message to 
those users. Use a text editor or the DCL command CREATE to create this 
file. 

When you create a distribution list, type one user name per line. You can 
also include the names of other distribution lists by specifying an at sign (@) 
followed by the name of the distribution list. Exclamation points (!) delimit 
comments in programs and command procedures. DCL ignores everything to 
the right of the exclamation point when processing the line. For example: 

! ALLBUDGET.DIS 

I 

! Budget Committee Members 
OBUDGET ! listed in BUDGET.DIS. 

! Staff 

HARRINGTON ! me 

BRUTUS::WILSON ! Martha Wilson 

PORTIA::RIPLEY ! Roy Ripley 

If the file BUDGET.DIS is not in the same directory as the new distribution list 
file you are creating, include the file specification for BUDGET.DIS in the new 
distribution file. (The file specification gives the system all the information 
necessary to locate a file. Depending on where you create ALLBUDGET.DIS, 
you may have to specify the device and directory in which BUDGET.DIS is 
located. See Chapter 2 for more information on file specifications.) 

To send a message to a distribution list from within MAIL, type an at sign 
and the file name at the To: prompt. For example: 

MAIL> SEND 

To: OALLBUDGET 

Subj: Tomorrow's Meeting 

By default, the system looks for a distribution list file with the file type 
DIS. If the file containing your distribution list has a different file type, you 
must specify the file name and file type at the To: prompt. If you invoke 
MAIL while in one directory and the file containing the distribution list is in 
another, enter the distribution list's file specification at the To: prompt. 
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1.4.1.3 Reading Mail 

Invoke MAIL to read an old or new mail message. Messages you receive are 
stored in mail files, which have a default file type of MAI. Your default mail 
file, MAIL.MAI, is created in your top level directory the first time you receive 
a mail message. 

By default, MAIL provides folders. New messages are automatically placed 
in a folder called NEWMAIL; old messages are held in a folder called MAIL. 
You can move between these folders to read old or new mail messages. 

Reading New Messages 

When you are logged in and receive a mail message, notice of the new 
message appears on your screen. (You can screen out notification of incoming 
messages by specifying the DCL commands SET TERMINAL/ 
NOBROADCAST or SET BROADCAST=NOMAIL.) For example, a message 
sent by user FELLINI appears as follows: 

New mail from FELLINI 

If you are part of a DEC-net VAX network and someone on a remote node 
sends you mail, the sender's node and name are indicated. 

If you have new mail, you are notified when you log in and when you invoke 
MAIL. To read a new message, invoke MAIL. MAIL displays the number 
of mail messages received and prompts for a command, as shown in the 
following example: 

$ MAIL 

You have 1 new message. 

MAIL> 

To read the new message, press RETURN. The message appears on your 
screen as follows: 

#1 31-DEC-1988 14:12:27 NEWMAIL 

From: FELLINI 
To: JONES 

Subj: Sales presentation on January 9 

The meeting to discuss the Hubbub Cola account has been moved 
from our conference room to the auditorium. Dress to impress. 

MAIL> 

You may have another new message. To read your next new message, press 
RETURN at the MAIL prompt. Pressing RETURN in MAIL is equivalent to 
specifying the READ command without parameters. When you have read all 
your new messages, MAIL issues the message "%MAIL-E-NOMOREMSG, 
no more messages," and continues to prompt for commands until you exit by 
entering EXIT or pressing CTRL/Z. 

If you receive a mail message while you are in MAIL, enter the READ/NEW 
command to read the new message. 
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Reading Old Messages 

If you have just read a new message and want to reread an old message, 
enter the following: 

MAIL> SELECT MAIL 

This command selects the MAIL folder. The SELECT command allows you to 
move between folders. Once you are in the MAIL folder, press RETURN at 
the MAIL prompt or use the READ command to read the old message. The 
first message (numbered 1) in your default mail file appears on your screen. 
Press RETURN to display the next message. If the message is too long to 
display on one screen, press RETURN to display the next part of the message. 
To skip part of a message and display the next message, type NEXT, which 
can be abbreviated to "N." 

You can display a list of all messages within the current mail folder by 
entering the DIRECTORY command. You can then display a particular 
message by entering the READ command and the number of the message, as 


shown in the following example: 



MAIL> DIRECTORY 



MAIL 

# From 

Date 

Subj ect 


1 DOLCE::FELLINI 

31-DEC-1988 

Sales presentation 

on January 9 

2 DOODAH::JONES 

31-DEC-1988 

status 


MAIL> READ 2 





You can also omit the READ command and enter just the number of the 
message. 

If you have many messages, you can locate a particular message by using 
the SEARCH command to find a specified string. To search for a string, 
specify that string as a parameter to the SEARCH command, as shown in the 
following example: 

MAIL> SEARCH "appointment" 

The SEARCH command selects and displays the first message in the current 
folder that contains the specified string. 

To search for a new string, specify the string as a parameter to the SEARCH 
command. Each time you specify a new string, the SEARCH command 
starts the search at message number 1. To continue searching the folder 
for messages that contain the specified string, use the SEARCH command 
without specifying a parameter. 


1.4.1.4 Creating a File from a Mail Message 

To copy a mail message to a text file, enter the EXTRACT command while 
you are reading the message. When you exit from MAIL, the file is listed in 
your current directory (unless you specify another directory). The following 
example shows how to create a file named JANUARY_MEETINGS.TXT 
containing the text of message number 3: 

MAIL> READ 3 


MAIL> EXTRACT/NOHEADER JANUARY_MEETINGS.TXT 

‘/.MAIL-1-CREATED, DISKI: [JONES] JANUARY.MEETINGS.TXT; 1 created 

MAIL> 
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The mail header is composed of the From, To, and Subject lines. Specifying 
the /NOHEADER qualifier deletes the mail header and copies only the text 
of the message to the file. If the message has more than one header (as does, 
for example, a forwarded message), only the last header is deleted. 

Use the /APPEND qualifier to the EXTRACT command to copy a message to 
the end of an existing file. Use the /ALL qualifier to copy all the files in the 
current folder to an existing file. 


1.4.1.5 Deleting Mail 

To delete a mail message, either enter the DELETE command while you are 
reading the message or enter the DELETE command followed by the number 
(or range of numbers) of the message you want to delete. The following 
example deletes messages 4, 5, 6, 11, 12, 14, 15, 16, and 17. You can use 
either the hyphen (-) or the colon (:) to define the range of messages to be 
deleted. 

MAIL> DELETE 4-6,11,12,14:17 

When you delete a message, the message is moved to a folder called 
WASTEBASKET. During your interactive MAIL session, you can recover 
any deleted message by moving the message out of the wastebasket folder. 
(See Section 1.4.1.6 for information on moving messages between folders.) 
Deleted messages collect in the WASTEBASKET folder until you exit from the 
current mail file (either by exiting from MAIL or by specifying a different mail 
file). Once you exit from the current mail file, WASTEBASKET is emptied and 
the folder itself is deleted. (See Section 1.4.1.6 for a discussion of mail files.) 


1.4.1.6 Organizing Mail with Folders and Files 

By default, each user account has one mail file (called MAIL.MAI). MAIL- 
helps you organize your messages by providing the following folders as they 
are required: 

• NEWMAIL—Contains all messages that have not been read. If you 
invoke MAIL when you have a new message, you are placed into 
the NEWMAIL folder. Once you leave the NEWMAIL folder (either 
by exiting MAIL or by changing to another folder), MAIL moves any 
messages that have been read but not deleted to your MAIL folder and 
deletes the NEWMAIL folder if it is empty. 

• MAIL—Contains messages that have been read but not deleted. If you 
invoke MAIL and have no new messages, you are placed into the MAIL 
folder. 

• WASTEBASKET-Contains messages that have been deleted. This folder 
and its contents are deleted when you exit MAIL or specify a different 
mail file. 

You can extend this organizational scheme by creating your own folders. 
Each folder can contain any number of messages. 

Like the default folders, the folders you create are normally stored in the mail 
file MAIL.MAI. You can also create your own mail files; each mail file can 
contain any number of folders. Although you can create any number of mail 
files, you usually organize your messages by creating folders rather than by 
creating mail files. 
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Creating and Modifying Folders 

The following MAIL commands allow you to create and modify folders: 

• FILE—Files the current message in the folder you specify. If the folder 
does not exist, you are asked whether you want to create it. After being 
filed, the message is automatically deleted from the current folder. 

• COPY—Places a copy of the current message into the folder you specify. 
If the folder does not exist, you are asked whether you want to create 
it. The following commands copy all messages containing the word 
MEETING from the current folder to a folder named SCHEDULE. After 
the commands are executed, you have two copies of each message, one 
in the current folder and one in folder SCHEDULE. The first command 
selects and displays the first message containing the word "meeting": 

MAIL> SEARCH MEETING 

MAIL> COPY SCHEDULE 

Folder SCHEDULE does not exist. 

Do you want to create it (Y/N, default is N)?Y 
•/.MAIL-I-NEWFOLDER, folder SCHEDULE created 

This command selects and displays the next message containing 
"meeting": 

MAIL> SEARCH 

MAIL> COPY MEETING 
MAIL> SEARCH 

•/.MAIL-E-NOTFOUND, no messages containing 'MEETING' found 

• MOVE—Synonymous with the FILE command. 

Selecting Folders 

The name of the current folder is displayed in the top right corner of the 
screen each time you enter a READ or DIRECTORY command. You can work 
only with messages that are in your current folder. 

To display a list of the folders in your current mail file, enter the 
DIRECTORY/FOLDER command, as shown in the following example: 

MAIL> DIRECTORY/FOLDER 

Listing of folders in SYS$L0GIN:[JONES]MAIL.MAI;1 
Press CTRL/C to cancel listing 
MAIL MEETING_MINUTES 

MEMOS PROJECT.NOTES 

STAFF 

To select a new folder as your current folder, use one of the following 
commands: 

• SELECT—Selects the specified folder as the current folder. 

• DIRECTORY—Selects the specified folder as the current folder and lists 
the messages in the folder. 

• READ—Selects the specified folder as the current folder and displays the 
specified message (by default, the first message in the folder). 
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Deleting Folders 

To delete a mail folder, delete all the messages in the folder or move them to 
another folder. The following example deletes the MUSIC folder: 

MAIL> SELECT MUSIC 

# / 0 MAIL-1-SELECTED, 2 messages selected 
MAIL> DELETE/ALL 

Creating and Accessing Mail Files 

To create a mail file, move a message into the file by entering the COPY, 
MOVE, or FILE command as you would to create a folder. When MAIL 
prompts you for the name of the folder, specify the name of the mail file after 
the name of the folder. 

The following example creates the mail file ACCOUNTS.MAI, moves the 
current message into a folder named FEED in the file ACCOUNTS.MAI, and 
deletes the message from its current folder and file: 

MAIL> MOVE 
.Folder: FEED [Hr] 

.File: ACCOUNTS OH] 

To work within a mail file other than the default mail file, use the MAIL 
command SET FILE to specify the alternate file. (The MAIL command SHOW 
FILE displays the name of the current mail file.) When you change mail files, 
the WASTEBASKET folder of the current mail file is emptied and deleted, and 
the mail file is closed. 


1.4.1.7 Using the Mail Keypad 

You can use the keypad to execute commands in the Mail Utility. Most of the 
keypad keys can execute two commands. To enter the top command for each 
key shown in the following diagram, press the appropriate key. To enter the 
bottom command shown in the following diagram, press the PF1 key before 
you press the key. 
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For example, to execute the MAIL command SEND, press the keypad key 7 
(KP7). To execute the MAIL command SEND/EDIT, press the PF1 key first 
and then press KP7. (For more information on mail keypad commands, see 
the VMS Mail Utility Manual) 

You can redefine the keypad keys to execute MAIL commands when you 
are in the Mail Utility. Defining keypad keys in MAIL is similar to defining 
keypad keys to execute DCL commands; see the DEFINE/KEY command in 
the VMS Mail Utility Manual for more information. 


1.4.1.8 Setting the Default Editor 

By default, MAIL invokes the EDT editor when you specify the MAIL 
command SEND/EDIT. By entering the TPU parameter to the MAIL 
command SET EDITOR, you can specify that the TPU editor be invoked 
instead. (EVE is the default TPU editor.) The TPU editor remains your 
default MAIL editor (even if you log out of the system and log back in) until 
you enter the SET EDITOR EDT command. 

The following example sets the default MAIL editor to TPU: 

MAIL> SET EDITOR TPU 
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In the following example, the default MAIL editor has been set to TPU, and 
the MAIL command SEND/EDIT has been entered at the MAIL prompt. You 
see the following screen display: 


Buffer MAIN I Insert I Forward 

Enter the text of your message, using EVE commands to move around in 
the buffer, which is a temporary storage area that exists only during an 
editing session. Send the message by pressing CTRL/Z. (See Chapter 8 and 
the Guide to VMS Text Processing for information about using EVE and EVE 
commands.) 

You can display the default MAIL editor by entering the MAIL command 
SHOW EDITOR, as shown in the following example: 

MAIL> SHOW EDITOR 
Your editor is TPU. 


1.4.2 Using the Phone Utility 

The VMS Phone Utility (PHONE) allows you to "talk" by way of your 
terminal screen to other users on your system or on any other VAX computer 
connected to your system by means of DECnet-VAX. The Phone Utility 
simulates the functions and features of a telephone. To invoke the Phone 
Utility, type PHONE at the DCL prompt. Your screen display splits 
horizontally into two sections. Your name is in the top section. At the 
switchhook character (the % sign), type the name of the person you want to 
call. Type the following to reach user SMITH on node CHEETA: 

# /, CHEETA: :SMITH 

If you are calling another user on your node, or if your computer system is 
not part of a network, type only their user name. 

PHONE rings the other party. If that person answers your call, their name 
appears in the bottom section. You can begin typing your conversation. If 
your call is not answered, you will be informed that the person is unavailable. 

To answer a call from another user, invoke PHONE. Again, your terminal 
screen splits into two sections, with you in the top section. Enter the 
ANSWER command at the switchhook character. When you finish typing 
your conversation, enter the EXIT command or press CTRL/Z to exit from 
PHONE. 

For more information about PHONE commands, see the VMS Phone Utility 
Manual or type HELP at the PHONE prompt. 
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1.4.3 



Using the Sort/Merge Utility 

The VMS Sort Utility (SORT), invoked with the DCL command SORT, sorts 
records from one or more input files according to the fields you select and 
generates one reordered output file. The Sort Utility reorders records in a file 
(or files) so that they are in alphabetic or numeric order, either low to high 
(ascending) or high to low (descending), according to a portion of each record 
called the key. By default, the Sort Utility sorts on the first character of the 
first field in each record contained in the input file. 

The VMS Merge Utility (MERGE), invoked with the DCL command MERGE, 
combines up to ten previously sorted files into one ordered output file. By 
default, MERGE does sequence checking to ensure the input files are in order. 
The sequence check stops the merge if a record is found to be out of order. 
To prevent sequence checking during the merge, specify the 
/NOCHECK_SEQUENCE qualifier. 

For more information about the SORT/MERGE parameters and qualifiers, see 
the VMS Sort/Merge Utility Manual. 


1.4.3.1 



Sorting Records 

A file record can be thought of as a line of text in a file. Record sorting, 
the default sort operation, keeps records intact and produces an output file 
consisting of complete records. Records can be subdivided into fields, which 
describe individual segments of the record. A field is specified by the starting 
position of its first character in the record and the length, in characters, of 
the field. You can sort records based on the contents of certain fields by 
specifying the field as a sort key. 

The following example illustrates an ascending (the default) record sort based 
on that portion of each record starting at character position 8 and extending 
to the end of the record (the name): 

$ S0RT/KEY=(P0SITI0N=8.SIZE=15) EMPLOYEE.LST BYNAME.LST 



- EMPLOYEE.LST - 


- BYNAME.LST- 

B 7828 MCMAHON JANE 


A 8042 BENTLEY PETER 

A 7933 ROSENBERG HARRY 


C 8102 KNIGHT MARTHA 

C 8102 KNIGHT MARTHA 


B 7951 LONG FRANK 

A 8042 BENTLEY PETER 


B 7828 MCMAHON JANE 

B 7951 LONG FRANK 


A 7933 ROSENBERG HARRY 


ZK-1748-84 


The following example sorts the same file in descending order using the field 
in character positions 3 through 6 (the number) as the sort key: 

$ S0RT/KEY=(P0SITI0N=3,SIZE=4.DESCENDING) EMPLOYEE.LST BYNUMBER.LST 
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- EMPLOYEE.LST - 


- BYNUMBER.LST - 

B 7828 MCMAHON JANE 


C 8102 KNIGHT MARTHA 

A 7933 ROSENBERG HARRY 


A 8042 BENTLEY PETER 

C 8102 KNIGHT MARTHA 


B 7951 LONG FRANK 

A 8042 BENTLEY PETER 


A 7933 ROSENBERG HARRY 

B 7951 LONG FRANK 


B 7828 MCMAHON JANE 


ZK-1749-84 


The first parameter of the SORT command names the file or files to be sorted. 
Multiple files are treated as one large file for sorting purposes. The second 
parameter provides a name for the ordered output file that the sort will create. 
The following example sorts the records in two files, EMPLOYEE.LST and 
EMPLOYER.LST, and creates the ordered output file BYNAME.LST: 

$ SORT EMPLOYEE.LST.EMPLOYER.LST BYNAME.LST 

Single Key 

By default, the SORT command assumes that a key field in a record has the 
following characteristics: 

• Begins in the first position of a record 

• Includes the entire record 

• Contains character data 

• Will be sorted in ascending order 

Use the /KEY qualifier to specify characteristics of the key field other than 
those assumed by default. 

In the following example, the /KEY qualifier specifies that the key field starts 
in position 8 and is 15 characters long: 

$ S0RT/KEY=(P0SITI0N=8.SIZE=15) EMPLOYEE.LST BYNAME.LST 

(If an actual key would have to extend beyond the end of the record to 
meet the size specification—for example, if the key is the last item in a 
variable-length format—the missing characters are treated as null characters.) 

Multiple Keys 

You can specify more than one key field, up to a limit of 255 characters. Each 
key can be ascending or descending. Specify multiple keys in the order of 
their priority in the sort. For example, the following command sorts records 
first on the value of position 1 in descending order, then on the value of 
positions 8 through 27 (or the end of the record) in ascending order: 

$ S0RT/KEY= (POSITIONS,SIZE=1 .DESCENDING) - 
_$ /KEY=(P0SITI0N=8,SIZE=15) - 
_$ EMPLOYEE.LST DEPTNAME.LST 
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The results of the sort specified in the preceding example are as follows: 


-EMPLOYEE.LST- 

B 7828 MCMAHON JANE 


-DEPTNAME.LST- 

C 8102 KNIGHT MARTHA 

A 7933 ROSENBERG HARRY 


B 7951 LONG FRANK 

C 8102 KNIGHT MARTHA 


B 7828 MCMAHON JANE 

A 8042 BENTLEY PETER 


A 8042 BENTLEY PETER 

B 7951 LONG FRANK 


A 7933 ROSENBERG HARRY 


ZK-1764-84 


By default, records with identical keys are kept but not sorted predictably. 
To retain identical keys and arrange them according to the input file order, 
specify the /STABLE qualifier. To eliminate duplicate keys, specify the 
/NODUPLICATES qualifier. 


1.4.3.2 Other Types of Sorting 

In addition to record sorting, you can perform the following types of sort 

operations: 

• Tag sort—Sorts the keys only and then rereads the input file to produce 
an output file of complete records. The net result is the same as for a 
complete record sort. A tag sort is useful if disk space is at a premium, 
because it typically uses less scratch file space while sorting. Time may 
be saved if the records are large but the keys are relatively small. Specify 
the /PROCESS=TAG qualifier with the SORT command to generate a tag 
sort. 

• Address sort—Sorts the keys only and produces an output file of record 
addresses (RFAs) in binary format. An address sort is faster than a record 
sort, but to take advantage of this feature, you must write a program to 
associate the record addresses with the records of the input file. Specify 
the /PROCESS=ADDRESS qualifier to generate an address sort. 

• Indexed sort—Sorts the keys only and produces an output file of keys and 
record addresses (RFAs). The addresses are in binary format. An index 
sort is faster than a record sort, but, to take advantage of this feature, you 
must write a program to associate the record addresses with the records 
of the input file. Specify the /PROCESS=INDEX qualifier to generate an 
index sort. 


1.4.3.3 Character Data Files 

The SORT command assumes by default that the files to be sorted contain 
character data. Characters are sorted according to a collating sequence, which 
describes the order in which characters are arranged (A, B, C, and so on). 

ASCII is the default collating sequence for character data. In general, ASCII 
orders numbers (0 through 9) first, then uppercase letters (A through Z), and 
then lowercase letters (a through z). 

You can specify the EBCDIC collating sequence to generate an output file that 
is ordered in EBCDIC sequence (although it remains in ASCII representation). 
To use the EBCDIC collating sequence, specify the 
/COLLATING_SEQUENCE=EBCDIC qualifier. 
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The multinational collating sequence collates characters according to the 
international character set defined by DIGITAL (see Appendix A). The 
multinational collating sequence compares for different characters first, 
then for different diacritical forms of the same character (formed by using 
diacritical marks as part of "compose sequences" on VT200-series terminals), 
and then for different cases (uppercase or lowercase) of the same character. 
To use the multinational collating sequence, specify the 
/COLLATING_SEQUENCE=MULTINATIONAL qualifier. 

Note: Use caution when using the multinational collating sequence to sort 
or merge files for further processing. Sequence-checking procedures in 
most programming languages compare numeric characters. Because the 
multinational sequence is based on actual graphic characters (and not the 
codes representing those characters), normal sequence checking will not 
work. 


1.4.3.4 Noncharacter Data Files 

If you sort files containing items other than character data, you must specify 
the data type of each key. Also, you must take care in calculating starting 
positions and sizes, because the items being compared may occupy more than 
one byte. For example, if you are sorting a file that contains 20 characters 
followed by 3 floating-point numbers in F-floating format, and the key is the 
last floating-point number, you must make the following specification: 

$ S0RT/KEY=(P0SITI0N=29,F_FL0ATING) STATS.RAW STATS.SOR 

In the example, the character data occupies positions 1 through 20 (20 
characters), the first F_floating-point number occupies position 21 through 24, 
the second E-floating-point number occupies positions 25 through 28, and 
the third F_floating-point number occupies positions 29 through 32. The size 
of the floating-point number is not specified (since it is fixed at 4 bytes). 


1.4.3.5 Terminal Input 

The records to be sorted or merged need not be in a file. You can enter 
the records directly from the terminal as you enter the SORT or MERGE 
command. 

To enter the input records for a sort or merge operation from your terminal, 
specify SYS$INPUT as the input file parameter, qualifying it with the size 
of the longest record (in bytes) and the approximate size of the input file (in 
blocks). After you enter the command, enter the input records on successive 
terminal lines. Terminate each record by pressing RETURN. Terminate the 
file by pressing CTRL/Z. 

The following example demonstrates a sort operation in which the input 
records to be sorted are entered directly from the terminal: 

$ S0RT/KEY=(P0SITI0N=8,SIZE=15) - 

_$ SYS$INPUT/FORMAT=(REC0RD_SIZE=22,FILE_SIZE=10) BYNAME.LST 
B 7828 MCMAHON JANE [Ml 
A 7933 ROSENBERG HARRY [ret! 

C 8102 KNIGHT MARTHA IretI 
A 8042 BENTLEY PETER [Ml 
B 7951 LONG FRANK [ret| 

fCTRL/Z) 
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1.4.3.6 Output File Organization 

You must specify the file organization of the output file of a sort or merge 
operation if that organization differs from that of the input file. The following 
example assumes that EMPLOYEE.LST is an indexed file and you want the 
output file produced by the sort to be a sequential file (for more information 
on file organization, see Section 2.1.2): 

$ S0RT/KEY=(P0SITI0N=8.SIZE=15) - 
_$ EMPLOYEE.LST BYNAME.LST/SEQUENTIAL 

If the organization of the output file is indexed, the file must already exist 
and must be empty. You must also qualify the output file parameter with 
/OVERLAY. 


1.4.3.7 Batch Job Submission 

If you are sorting large files, you should consider submitting the sort 
operation as a batch job, since the sort will require some time. Batch jobs 
are programs or DCL command procedures that run independently of your 
current session. See Sections 3.1.2 and 3.1.4 for more information about 
command procedures and batch jobs, respectively. 

If the records to be sorted are in a file, the command procedure you submit as 
a batch job must contain the SORT command and explicitly set your default 
directory or include the directory in the command file specifications. The 
following example submits the DCL command procedure SORTJOB.COM 
as a batch job. The text of the command procedure is shown following the 
command line: 

$ SUBMIT SORTJOB 

! SORTJOB.COM 
! 

$ SET DEFAULT [USER.PER] ! Set default to location of input files 
$ S0RT/KEY=(P0SITI0N=8,SIZE=15) EMPLOYEE.LST BYNAME.LST 

You can include the input records in the batch job by placing them after the 
SORT command, one record per line, as shown in the following example. 

As with terminal input of records, you specify the input file parameter as 
SYS$INPUT and qualify it with the record size (in bytes) and the approximate 
file size (in blocks): 

$ SUBMIT SORTJOB 

! SORTJOB.COM 
! 

$ SET DEFAULT [USER.PER] 

$ S0RT/KEY=(P0SITI0N=8,SIZE=15)- 
SYS$INPUT- 

/F0RMAT=(REC0RD_SIZE=22,FILE_SIZE=10)- 
BYNAME.LST 
B 7828 MCMAHON JANE 
A 7933 ROSENBERG HARRY 
C 8102 KNIGHT MARTHA 
A 8042 BENTLEY PETER 
B 7951 LONG FRANK 
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1.4.3.8 


Merging Files 

The MERGE command combines up to 10 sorted files into one ordered output 
file. The input files must all have the same format, and all must have been 
sorted on the same key fields. 

The following example demonstrates the merging of two files based on the 
field in each record starting at position 8 and extending to the end of the 
record (the name field): 

$ MERGE/KEY=(P0SITI0N=8,SIZE=15) BYNAME1.LST,BYNAME2.LST BYNAME3.LST 

- BYNAME1 .LST- 

A 8042 BENTLEY PETER 
C 8102 KNIGHT MARTHA 
B 7951 LONG FRANK 
B 7828 MCMAHON JANE 
A 7933 ROSENBERG HARRY 


-BYNAME2.LST- 

C 7212 KRAMER KARL 
C 8323 NORTON FLORENCE 
A 8240 TROUT SAM 


ZK-1771-84 


-BYNAME3.LST- 

A 8042 BENTLEY PETER 
C 8102 KNIGHT MARTHA 
C 7212 KRAMER KARL 
B 7951 LONG FRANK 
B 7828 MCMAHON JANE 
C 8323 NORTON FLORENCE 
A 7933 ROSENBERG HARRY 
A 8240 TROUT SAM 


By default, MERGE does sequence checking to ensure the input files are in 
order. The sequence check stops the merge and reports an error if a record 
is found to be out of order. To prevent sequence checking during the merge, 
specify the /NOCHECK_SEQUENCE qualifier. 
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In the VMS operating system, information is hierarchically stored. At the 
top of this hierarchy is the master file directory (MFD). Your user file directory 
(UFD) is listed in this master file directory, along with the user file directories 
of other users. Your user file directory (usually called usemame.DIR) is a file 
that points to your top level directory, which is also called your login directory 
or default directory because the system places you there by default when you 
log in. This top level directory contains the files and subdirectories that you 
have created or that have been created for you. It is from your top level 
directory that you perform most of your daily online tasks. 

An MFD and UFDs are stored on physical devices called disks. The access 
path to a file is through the node and device, through a top level directory, 
through any subdirectories, and then to the file. 

Your directory structure resembles a family tree. At the top is your top level 
directory, which branches off to files and to subdirectories, which branch still 
further. You can ascend and descend the directory structure to access your 
files and subdirectories. You can also access other directory structures that 
have been set up to allow public access. With the correct process privileges, 
you can also access files and directories on remote systems. Process privileges 
control what commands and functions you are authorized to execute from 
your account. See the Guide to Setting Up a VMS System for more information 
about process privileges. 


Files 

A file contains information. This information can be machine-readable data 
that the computer understands. It can also be text you enter and manipulate. 
The text in the file might be the text of a document; a program that you can 
execute, written in a language such as C or Pascal; or a list of addresses. You 
can examine the data in these files by displaying the files on a terminal screen 
and printing them on paper. 

Every file must have a file name or file type to identify it to both the system 
and you. A file also has a version number. This file information is specified 
using the following format: 

filename. type;version 

Taken together, these elements form a file specification. The following section 
describes the elements of a file specification and the rules for specifying these 
elements. 
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2.1.1 File Names, Types, and Versions 

When you create a file, give it a name that is meaningful to you. The file 
name can be from 0 through 39 characters chosen from the letters A through 
Z (upper- or lowercase), the numbers 0 through 9, an underscore (__), a 
hyphen (-), or a dollar sign ($). Do not use a hyphen as the first or last 
character in the file name. Do not begin a file name with a dollar sign, 
although it is a legal character within the file name. 

A file type identifies the nature of a file. The file type can be from 0 through 
39 characters and must be preceded by a period. The rules for creating file 
names also apply to file types. 

Including a file type is optional. With certain commands, if you omit the file 
type, the system applies a default value. Table 2-1 lists some of the more 
common default file types used by DCL commands. It also lists the default 
file types for some high-level language source programs. 

Table 2—1 Default File Types 

File Type Contents 

Default File Types for DCL Commands 

CLD Command description file 

COM Command procedure file 

DAT Data file 

DIS Distribution list file for the MAIL command 

DIR Directory file 

EDT Startup command file for the EDT editor 

EXE Executable program image file created by the linker 

HLP Input source file for help libraries 

JOU Journal file created by the EDT editor 

LIS Listing file created by a language compiler or assembler; default 

input file for the PRINT and TYPE commands 

LOG Batch job output file 

MAI MAIL message file 

MEM Output file created by DIGITAL Standard Runoff (DSR) 

OBJ Object file created by a language compiler or assembler 

RNO Input source file for DIGITAL Standard Runoff 

SIXEL Sixel graphic file 

SYS System image 

TJL Journal file created by the VAXTPU and ACL editors 

TMP Temporary file 

TPU Command file for the VAXTPU editor 

TXT Input file for text libraries or MAIL command output 


2-2 









Working with Files and Directories 

2.1 Files 


Table 2-1 (Cont.) Default File Types 


File Type 


Contents 


Default File Types for Language Source Programs 


ADA 

BAS 

B32 

C 

COB 

FOR 

MAR 

PAS 

PLI 


Input source file for the VAX Ada compiler 
Input source file for the VAX BASIC compiler 
Input source file for the VAX BLISS-32 compiler 
Input source file for the VAX C compiler 
Input source file for the VAX COBOL compiler 
Input source file for the VAX FORTRAN compiler 
Input source file for the VAX MACRO compiler 
Input source file for the VAX Pascal compiler 
Input source file for the VAX PL/I compiler 


In addition to a file name and type, every file has a version number. Version 
numbers are decimal numbers from 1 to 32,767 that differentiate versions of 
a file. When you initially create a file, the system assigns it a version number 
of 1. 

You may have several versions of a file. Unless you specify a version number, 
the system uses the highest existing version number of that file. When you 
modify that file, the system saves the original file and produces a modified 
output file. By default, this output file has the same name and type as the 
original, but the version number is incremented by one. 

Version numbers must be preceded with a semicolon or a period. When the 
system displays file specifications, it generally displays a semicolon in front of 
the file version number. 

The following example shows how to display the latest version of the file 
STAFE_VACATIONS.TXT. Because the system displays the latest version of a 
file by default, you can omit the version number from the file specification. 

$ TYPE STAFF_VACATIONS.TXT 

You can refer to versions of a file in a relative manner by specifying a zero 
or a negative version number. Specifying zero locates the latest (highest 
numbered) version of the file. Specifying -1 locates the next-most-recent 
version, -2 the version before that, and so on. 

You can control the number of versions of a file by specifying the 
/VERSION —LIMIT qualifier to the DCL commands CREATE/DIRECTORY, 
SET DIRECTORY, and SET FILE. 
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2.1.2 File Characteristics 

A file consists of records, each of which consists of a number of bytes of data. 
(Bytes are commonly used to represent characters.) A file's characteristics 
describe the physical layout of a file and determine how the file is treated 
during file operations. Specifically, file characteristics describe the following 
features of a file: 

• File organization—Sequential, indexed, or relative. 

The records of a sequential file are arranged one after another in the order 
of creation. Records must be read from the file in order. The file must 
be rewritten (that is, another file or version of the file must be created) to 
update it. 

The records of an indexed file are arranged randomly and accessed 
through one or more indexes. An index contains a portion of each record 
called a key; the keys are arranged in sequence from lowest to highest 
(by binary, numeric, or ASCII value depending on data type); one key 
is called the primary key. You can read a record directly (randomly) by 
specifying an index and the value of one of its keys. You can read records 
sequentially by specifying an index—records are read in ascending 
sequence according to the key values for that index, starting with the 
current record. Update an indexed file in place by adding, deleting, or 
changing records. Indexed files require more space since, in addition to 
the data, the indexes must be stored. 

The records of a relative file are arranged in fixed-length, numbered cells. 
The cell numbers are used to determine the position of the record in the 
file. As with indexed files, you can read records sequentially or randomly. 
Typically, relative files are created and accessed by programs, rather than 
from DCL command level. 

• Record format—Indicates the way all records in a file appear physically 
on the recording surface of the storage medium. Record format is defined 
in terms of record length and can be fixed length, variable length, variable 
length with fixed control area (VFC), or stream. All records in a fixed- 
length file are the same size. Records in a variable-length file vary in size. 
Records in a VFC file have a fixed-length header followed by a variable 
part. Note that VFC record format is not applicable for indexed files. 
Records with stream format are delimited with special control characters. 

• Data type—Strictly speaking, a file does not have a data type, because 
programs processing a file must know how each item in the file is to 
be interpreted. However, a file whose records contain all character data 
(each item is one byte, interpreted according to ASCII conventions) is 
called a text, or character, file. A file whose data is formatted as integers, 
floating-point numbers, object code, or other non-ASCII data is called a 
binary file. 

• Carriage control—New line (also known as "implied," "carriage return," 
or "CRLF"), FORTRAN carriage control, none, or print. New line places 
a carriage return and line feed at the end of each record when it is 
displayed or printed. FORTRAN carriage control uses the first character 
of each record to specify carriage-control information. "None" does not 
place carriage-control characters into a file; if you want to include control 
characters in the file, you must specify them as part of the data in the 
file. Note that the PRINT and TYPE commands interpret carriage-return, 
line-feed, and form-feed characters embedded in records. Print carriage 
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control interprets the two bytes of each VFC record as prefix and postfix 
carriage-control information. 

Files you create using the editor or the CREATE command use new-line 
carriage control. Each time you press RETURN, you create a new record. 
When the file is printed or typed, each record appears on a new line. 
Files you create using the OPEN, WRITE, and CLOSE commands use 
print carriage control. Each WRITE command adds a new record (in VFC 
format) to the file. 

• File size—The size of a sequential file with fixed-length records can 
be calculated by multiplying the number of records and the size of 
each record. Variable-length records require two extra bytes per record, 
and indexed files require space for the indexes. In addition to the files 
themselves, the VMS system uses disk space to store directory entries, file 
headers, and other file-maintenance information. 


At DCL level, you normally deal with sequential, variable-length text files, 
although some commands permit access to indexed files. You can examine a 
file's characteristics with the /FULL qualifier of the DIRECTORY command, 
as shown in the following example: 


$ DIRECTORY/FULL RECEIPTS.DAT 


Directory DISKI:[JONES.TAXES] 


RECEIPTS.DAT;15 


Size: 64/66 

Created: 02-JUN-1988 17:47:26.30 
Revised: 31-DEC-1988 11:28:51.35 (2) 
Expires: <None specified> 

Backup: 30-DEC-1987 22:48:08:23 


File ID: (103,75,0) 
Owner: [200,200] 


File organization: 
File attributes: 

Record format: 

Record attributes: 
Journaling enabled: 
File protection: 
Access Control List: 


Sequential 

Allocation=153, Extend=0 Global Buffer Count 
No version limit 

Variable length, maximum 82 bytes 
Carriage return carriage control 
None 

System:RWED, Owner:RWED, Group:RW, World: 
None 


Total of 1 file, 64/66 blocks. 


The file size of the preceding example indicates that 64 blocks have been 
used out of the 66 allocated. (File size is the number of actual blocks used of 
the blocks that have been allocated; more will be allocated by the system as 
needed.) If you are only interested in the size of the file (or several files), use 
the /SIZE qualifier. The following example lists the number of blocks used 
by the files in one directory. 


$ DIRECTORY/SIZE 

Directory DISKI:[JONES.TAXES] 


BILLING.DAT;31 62 
LEGAL.TXT;9 20 
LOCAL.DIS;2 4 
PROPERTY.DIR;1 7 
RECEIPTS.DAT;15 64 
SALES.DIR;1 5 


Total of 6 files, 162 blocks. 
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2.2 Directories 

A directory is a special kind of file that catalogs (by name and location) a 
set of files. A directory file contains the following information for every file 
cataloged within it: 

• The file name, type, and version number 

• A pointer to the file header, which describes, among other things, the 
file's owner, protection code, and location 

A directory file has the following format: 
directory.DIR; 1 

For example, DOG.DIR;l is a directory file. Because you cannot edit a 
directory file, all directory files have a version number of 1. 

In addition to the file name, a file specification can include the directory in 
which the file is located. The following example shows the file specification 
used to display the file STAFF_VACATIONS.TXT located in the directory 
[JONES]: 

$ TYPE [JONES]STAFF.VACATIONS.TXT 

If you omit the directory name from the file specification, the current directory 
is assumed by default. 


2.2.1 Directory Structure 

Each disk contains a main directory that is set up by the system manager. 
This main directory is called the master file directory (MFD). The MFD 
contains a list of user file directories (UFDs). User file directories are files 
in the master file directory that point to top level directories. Your top level 
directory is also called your login or default directory. Unless your account has 
been specially modified to do otherwise, by default the system places you in 
your top level directory when you log in. 

A UFD exists for each user on the system. It contains the names of and 
pointers to files cataloged in a user's directory. A subdirectory is any directory 
file that is not an MFD or a UFD. Subdirectories let you organize files into 
meaningful groups. Like a directory, a subdirectory contains names and 
pointers for the files cataloged within it. It can contain an entry for another 
subdirectory, which can contain an entry for another subdirectory, and so on 
to seven levels of subdirectories. This structure (a first level directory plus a 
maximum of seven levels of subdirectories) is called a hierarchical directory 
structure. 

Figure 2-1 shows a sample directory hierarchy. At the top of the 
structure is the MFD. Its directory name is [000000]. (Directory names are 
always enclosed in either square brackets ([ ]) or angle brackets ( < > ).) 
Figure 2-1 contains entries for user file directories including MARTINO.DIR, 
PUBLIC.DIR, SCHULTZ.DIR, and JONES.DIR. The top level directory 
[JONES] exists as a user file directory named JONES.DIR;l in [000000]. 

Assume that you are user JONES. At login, you are placed in [JONES], 
your default directory. [JONES] contains four nondirectory files and two 
directory files. The directory file TAXES.DIR;1 points to the [JONES.TAXES] 
subdirectory; LICENSES.DIR;1 points to the [JONES.LICENSES] subdirectory. 
(Subdirectories are specified by concatenating the subdirectory name to 
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the name of the directory one level above it.) The [JONES.LICENSES] 
subdirectory contains three nondirectory files and two directory files. The 
directory file DOG.DIR;l points to the [JONES.LICENSES.DOG] subdirectory; 
MARRIAGE.DIR points to the [JONES.LICENSES.MARRIAGE] subdirectory. 

This sample directory structure is the basis for the examples in this chapter, 
which demonstrate how to ascend and descend the directory structure and 
how to access files within this structure. 

Figure 2-1 Directory Structure 


MASTER DIRECTORY: 


TOP LEVEL DIRECTORY: 


SECOND LEVEL DIRECTORY: 


[ 000000 ] 


MARTINO.DIR 
PUBLIC.DIR 
JONES.DIR 





[JONES1 


LOGIN.C0M;3 
LOGIN. COM ;4 
STAFF.DIS;3 


ST AFF_V ACATI0NS.TXT;2 ( 


LICENSES.DIR 
TAXES.DIR;1 

;1 


[JONES. 

TAXES] 

BILLING.DAT;31 

LEGAL.TXT.9 

LOCAL.DIS;2 

RECEIPTS.DAT; 15 


PROPERTY. Dll 
SALES.DIR; 1 

*;1 





[JONES. LICENSES] 


MAILING.LIS;6 

TOTAL.DAT.2 

DEPT.DAT;3 


DOG.DIR; 1 
MARRIAGE.D 

IR; 1 





THIRD LEVEL DIRECTORY: 


[JONES. TAXES. SALES] 


FEDERAL.LIS;6 

STATE.LIS;2 


[JONES. TAXES. PROPERTY] 


DISTRICT 1.DAT; 1 
DISTRICT2.DAT.4 
DISTRICT3.DAT;2 


[JONES.LICENSES.MARRIAGE] 


CURRENT.DAT;6 
FEES.DAT; 11 
1980S.DAT;2 


[JONES. LICENSES. DOG] 


FEES.DAT;4 
FEMALE.LIS;6 
MALE.LIS;3 
P0UND.LIS;17 


ZK-1746-84 
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2.2.2 Directory Names 

Use a named directory specification to refer to a directory. A named directory 
specification consists of a top level directory name that can be followed by a 
maximum of seven subdirectory names. 

A named directory specification has the following format: 

[directory, subdirectory^ subdirectory...]] 

A directory name can contain up to 39 alphanumeric characters. Any 
characters valid for file names are also valid for directory names. Enclose 
the directory name in either square brackets ([]) or angle brackets ( <> ). 

Default and wildcard characters can be applied. You use wildcard characters to 
apply DCL commands to multiple files rather than to one file at a time and to 
move around the directory structure. See Section 2.6.6.3 for more information 
about using wildcard characters in a named directory specification. 


2.3 Devices 

Files are stored on devices. In the VMS operating system, devices are 
classified as follows: 

• Mass storage devices save the contents of files on a magnetic medium. 
Files saved this way can be accessed, updated, modified, or reused at any 
time. Disks and magnetic tapes are mass storage devices. 

• Record-oriented devices read and write only single physical units of data 
at a time and do not provide online storage of the data. Terminals, 
printers, mailboxes, and card readers are record-oriented devices. 
(Printers and card readers are also called unit-record devices.) 

A device name has the following three parts: 

• The device type, which identifies the hardware device. (For example, an 
RP06 disk has the device type DB, and a TE16 magnetic tape has the 
device type MT.) 

• A controller designator, which identifies the hardware controller to which 
the device is attached. 

• The unit number, which uniquely identifies a device on a particular 
controller. 

The files you commonly access are stored on disks or magnetic tape. Your 
user file directory (UFD) and your default directory with all your files and 
subdirectories are located on a disk. You can use a file specification that 
contains directory information only if the file is located on a disk. Magnetic 
tapes do not have directory structures. To obtain a file stored on tape, use a 
file specification that contains only file information. 

If you want to access a file that is not located on your default device, you 
must specify the device name. For files on disks, you must also specify the 
directory where the file is cataloged. 

You can use physical, logical, or generic names, described in the following 
sections, to refer to devices. 
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2.3.1 Physical Device Names 

Each physical device known to the system is uniquely identified by a physical 
device name. The physical device name identifies the kind of device, for 
example a storage disk or a terminal. A device name has the following 
format: 

ddcu 

The fields are as follows: 

dd Device code that represents a device type. 

c Controller designation. The controller designation, along with 

the unit number, identifies the location of the device within the 
hardware configuration of the system. Controllers are designated 
with alphabetic letters A through Z. 

u Unit number. The unit number, along with the controller 

designation, identifies the location of the device within the 
hardware configuration of the system. Unit numbers are decimal 
numbers from 0 through 65535. 

The maximum length of the device name field, including the controller and 
the unit number, is 15 characters. When you specify a device name as part 
of a file specification, terminate it with a colon (:). If you do not specify a 
logical or physical device name, your default device name is supplied. 

In addition to directory and file information, a file specification can include the 
device on which a directory and file are located. In the following example, 
the file STAFF_VACATIONS.TXT is located in the directory [JONES], which 
is located on a device with the logical name DISK2. To display the file from 
device DISKI, enter the following file specification: 

$ TYPE DISK2: [J0NES3STAFF_VACATI0NS.TXT 

A disk or tape must be mounted on a device in order to be recognized by the 
system as a volume. The system also recognizes volume sets. A volume set 
consists of two or more related volumes. 

To access a file on a disk volume set, you have the following options: 

• Specify the name of the device on which the first volume in the set is 
mounted. For example, if the disks DUA1 and DUA2 have been mounted 
as one volume set, access a file on that disk volume set by specifying 
DUA1 in the file specification. 

• Specify the logical name assigned to the volume set when it was 
mounted. This is the preferred method because it allows system managers 
to move the volume to another device without disrupting users. 

To access a file on a tape volume set, specify any device that has been 
allocated to that volume set. For example, if the tapes MUA1 and MUA2 
have been mounted as one volume set, access a file on that tape volume set 
by specifying either MUA1 or MUA2 in the file specification. 
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2.3.2 Logical Device Names 

Your system manager has probably set up logical names to represent the 
devices on your system. Logical device names can be used to equate a 
somewhat cryptic device name to a short, meaningful name. Use these 
logical names, rather than the physical device names, to refer to devices. 

By using logical names, users can avoid making specific references to physical 
devices whose names may change. In daily system management, devices are 
sometimes shuffled about. You might not know when a storage disk is added 
to your system configuration and a frequently accessed file moved to that new 
disk. You continue to access the file with the same file specification because 
your system manager has redefined the logical name that previously pointed 
to one device to point to the new device. 

Consequently, if your file specification contains a logical device name, you 
can access the file regardless of which physical device holds the disk or tape 
on which the file is stored. Your system manager will ensure that logical 
device names are always equated to the correct physical devices. 

In the following example, a logical device name is used to specify the device 
containing the disk volume with the file STAFF_VACATIONS.TXT. Note that, 
like a physical device name, a logical device name must be terminated with a 
colon. 

$ TYPE DISKI:[J0NES3STAFF_VACATI0NS.TXT 

The VMS system also offers a special type of logical device name called a 
concealed device name. If a device has a concealed device name, the logical 
name (not the physical device name) will be displayed in system messages 
that refer to the device. 

See Chapter 4 for a complete discussion of the use of logical names. 


2.3.3 Generic Device Names 

A generic device name consists of the device code and omits the specific 
controller or unit number. When you use a generic device name, the system 
locates the first available controller or device unit whose physical name 
satisfies the portions of the generic device name you specified. 

When you use the DCL commands ALLOCATE and MOUNT, the system 
allows you to specify generic device names in which the controller, the unit 
number, or both is not specified. For example, if you enter the ALLOCATE 
command and specify only a device type, the ALLOCATE command locates 
the first available unit of that type. 

For all other DCL commands, the system goes to controller A if you omit the 
controller designation, and to unit number 0 if you omit the unit number. 
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2.4 Full File Specification 

As discussed in Chapter 1, a node is one of several VMS systems connected 
to form a computer network. If your VMS system is part of a network, the 
node that you access when you log in is your local node. Other nodes in 
the network are remote nodes. As a general user of the network, you can 
perform file operations on nodes other than the one at which you are logged 
in. 

A node name can contain 1 to 6 alphanumeric characters and must contain at 
least one alphabetic character. A node name must always be followed by a 
double colon (::). You can also use a logical node name in place of the node 
name. For more information on logical node names, see Section 4.8. 

When you add node information to the device, directory, and file information, 
you create a full file specification. A full file specification completely describes 
the access path the system uses to locate and identify a file. Because it 
describes the network node on which the file resides, a full file specification is 
also known as a network file specification. 

The format for a full file specification follows: 

node-name: :device:[directory filename.type;version 

Assuming the file protection is set to allow remote access, the following 
example shows the full file specification used to display the file 
STAFR_VACATIONS.TXT on node HUBBUB: 

$ TYPE HUBBUB::DISK1:[JONESjSTAFF_VACATIONS.TXT 

If you specify your local node in the file specification, DECnet-VAX logs 
you in over the network to perform the file operation, even though the 
file exists on your local node. To save time and reduce system overhead 
when accessing a file on your current node, omit the node name in the file 
specification. 

The full file specification can optionally include an access control string. To 
indicate that you are authorized to access a file protected against network 
access, include an access control string (a 0- to 42-character string that contains 
a user name and password). DECnet-VAX uses this access control string 
to log in at the remote node. The device, directory, and file information is 
passed to the remote node and interpreted there. 

The usual format for a full file specification that contains an access control 
string is as follows: 

node-name"username password"::device:[directory]filename.type;version 

Assume again that you are user JONES. The following example includes the 
access control string necessary for you to copy the file STAFE_SALARIES.TXT 
from your account on node HUBBUB to your default directory on another 
node. The asterisk at the end of the file specification is a wildcard character. 
Here, it instructs the system to duplicate the file name STAFF__SALARIES.TXT 
when that file is copied to the remote node. 

$ COPY HUBBUB"JONES PANDEMONIUM"::DISK1:[JONESjSTAFF_SALARIES.TXT * 
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If you omit the access control string, the login information sent to the remote 
node is determined as follows: 

• If a proxy login account exists for you on the remote node, the system 
logs you in using that account. (A proxy login account gives access 
privileges on a remote node to selected users who do not have a private 
account on that node.) 

• If no proxy login account exists, the system uses the default DECnet-VAX 
account for that node as specified by the local system manager. 

If a file resides on a non-VMS system (that is, the file specification does not 
conform to VMS syntax), the name of the file as specified in this format is 
enclosed in a quoted string. The quotation marks prevent the local VMS 
system from performing syntax checking or logical name translation. In the 
following example, the file TEST7.DAT contains a question mark character, 
which is not recognized as a valid file name character in VMS: 

$ COPY BOSTON::"TEST7.DAT" * 


2.4.1 Using System Default Values When Specifying Files 

When you enter a file specification, you can omit fields and let the system 
supply default values for these fields. Table 2-2 summarizes the defaults 
applied to each field in a file specification. 

Note that the system supplies the defaults described in Table 2-2 for the first 
input file specification that you enter on a DCL command line. 

Table 2-2 File Specification Defaults 
Field Defaults 


Node 


The system assumes that the default is the local system. 


Device 


Directory 
File name 


File type 
File version 


The system uses the device (usually a disk) established at login 
or by the SET DEFAULT command. Devices are usually identified 
with logical names. 

If a physical device (ddcu) is used and a controller designation is 
omitted, the controller designation defaults to A. If a unit number 
is omitted, the unit number defaults to 0. (The ALLOCATE, 
MOUNT, and SHOW DEVICES commands, however, treat a 
device name that does not contain controller or unit numbers as 
a generic device name.) 

The system uses the directory name established at login or by 
the SET DEFAULT command. 

No defaults are applied to the first file name in an input file 
specification. Most commands apply default output file names 
based on the file name of an input file. 

Various commands apply defaults for file types, based on the 
standard file type conventions summarized in Table 2-1. 

For input files, the system assumes the highest version number. 
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Table 2-2 (Cont.) File Specification Defaults 
Field Defaults 

For output files, if no file with the specified file name and file 
type exists in the current directory, the file is created with a 
version number of 1. However, if one or more versions do exist, 
the next highest version number is used. 


When you enter more than one input file specification, the system applies 
temporary defaults for node, device, and directory names. The system uses 
the preceding file specification in the list that included this information. The 
following examples show how the system applies temporary defaults. 

The following example copies the latest versions of 
DISKl:[JONES.TAXES.PROPERTYJDISTRICTl.DAT and 
DISKl:[JONES.TAXES.PROPERTYjDISTRICT2.DAT to the file AUDIT.DAT 
in the default directory. By default, the output (second) file specification 
parameter assumes the corresponding fields of the first file specification. 

$ COPY DISKI:[JONES.TAXES.PROPERTY]DISTRICT1.DAT,DISTRICT2 AUDIT 

When you want to specify the default file type, be sure to omit the period 
(which indicates a null file type). 

The following example copies the files DISKl:[JONES.TAXESJBILLING.DAT 
and DISKI :[JONES]STAFF.DIS to DISKl:[JONES]ASSIGNMENTS.DAT. Note 
that the output (second) file specification parameter uses the default directory, 
not the directory in the first input file specification. 

$ SET DEFAULT DISKI:[JONES] 

$ COPY [.TAXES]BILLING.DAT,[]STAFF.DIS ASSIGNMENTS.DAT 

The system applies defaults in different ways depending on the DCL 
command you specify. If, for example, you substitute the RENAME 
command for the COPY command in the previous example, you will 
produce one file [JONES.TAXESJASSIGNMENTS.DAT and another 
[JONESJASSIGNMENTS.DAT. See the VMS DCL Dictionary for more 
information on the defaults applied to specific DCL commands. 


2.5 File Operations 

File operations involve the creation, use, and deletion of files. File operations 
include the following: 

• Displaying the contents of files 

• Creating files 

• Modifying files 

• Copying files 

• Renaming files 

• Deleting files 

• Printing files 

• Purging files from directories 
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• Using wildcards 

As a VMS user, you can also perform file operations over the DECnet network 
if you have sufficient privileges. You can display locally the contents of 
remote directories and files and copy files from node to node. You can print 
files at the remote node where they reside, copy them to a remote printing 
device, or copy them to the local node for printing. DCL commands permit 
you to access common or public directories or databases located on any node 
on the network. You can display their contents or print or copy the files. 

See the descriptions of the DCL commands in the VMS DCL Dictionary for 
more information on specific file operations you can perform locally and over 
the network. 


2.5.1 Using Wildcards with File Specifications 

By using wildcard characters, you can apply a DCL command to multiple files 
rather than to one file at a time. The command applies to all files that match 
the portion of the file specification entered. 

With many DCL commands, you can use an asterisk (*) and a percent sign 
(%) as a wildcard in directory names, file names, and file types. You can also 
use the asterisk, but not the percent sign, in version numbers. 

The use of wildcard characters in DCL commands varies with the individual 
command. For more information on using wildcards with a particular DCL 
command, see the VMS DCL Dictionary. 


2.5.1.1 The Asterisk (*) Wildcard Character 

Use the asterisk wildcard character to match the following: 

• An entire field, or a portion of it, in the directory, file name, and file type 
fields 

• The entire version number field, but not a portion of it 

The following example displays all versions of the file LOGIN.COM in the 
directory [JONES]: 

$ TYPE [JONES]LOGIN.COM;* 

The following example displays all versions and all file types of all files that 
begin with the word STAFF in the directory [JONES]. This would include 
STAFF_VACATIONS.TXT and STAFF.DIS. 

$ TYPE [JONES]STAFF *.*;* 

You can also use the asterisk wildcard character in a directory specification. 
The following example displays all versions of all files with the file type .LIS 
in all subdirectories one level down from [JONES]: 

$ TYPE [JONES.*]*.LIS;* 

You can use the asterisk in the name, type, and version fields in output file 
specifications. Use an asterisk in an output file specification when you want 
the output files to match the corresponding field in the input files. 

The following example copies the latest versions of all DAT files in [JONES] 
to new files in [JONES] with the same name but a file type of SAV: 

$ COPY *.DAT *.SAV 
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The following example copies the latest versions of all DAT files in [JONES] 
beginning with the characters 19 to new files with the same names but in the 
directory [SAVE]: 

$ COPY 19*.DAT [SAVE]*.* 


2.5.1.2 The Percent (%) Wildcard Character 

The percent sign wildcard character can be used as a substitute for any single 
character in a file specification. You can use the percent sign in the directory, 
file name, and file type fields. You cannot, however, use the percent sign in 
the version number field. 

The following example displays the latest versions of all DAT files whose 
names begin with DISTRICT: 

$ TYPE [JONES.TAXES.PROPERTY]DISTRICT*/..DAT 

This display would include the files DISTRICT1.DAT, DISTRICT2.DAT, 
and DISTRICT3.DAT. The file DISTRICT4_5.DAT would not be displayed 
because it has more than one character after DISTRICT, nor would the 
file DISTRICT.DAT be displayed. The percent sign replaces one character 
position in a field, but there must be a character to replace. 


2.5.2 Displaying the Contents of Files 

You can display the contents of files on your terminal screen by using the 
TYPE command or by invoking an interactive text editor with the 
/READ-ONLY qualifier. The following example displays the file 
STAFE_VACATIONS.TXT: 

$ TYPE STAFF_VACATIONS.TXT 

The following example displays the file COMPANY_HOLIDAYS.TXT, which 
is located on remote node CHAOS: 

$ TYPE CHAOS::DISK2:[PUBLICiCOMPANY_HOLIDAYS.TXT 

If more than one file is listed in the TYPE command, the files are displayed in 
the order specified; if wildcard characters are used, the files are displayed in 
alphabetical order. 

To stop the scrolling of the text on the screen temporarily, press the HOLD 
SCREEN key (FI on VT200- and VT300-series terminals); to resume scrolling, 
press the HOLD SCREEN key again. To stop the display and return to DCL 
command level, press CTRL/Y or CTRL/O. 

If you specify the /PAGE qualifier to the TYPE command, you can view one 
screen at a time. The system prompts you to press RETURN when you want 
to see the next screen. 

By invoking an interactive text editor (for example, EVE or EDT) with the 
/READ-ONLY qualifier, you can use interactive editing commands to move 
around in a file and search for specific sequences of characters. The 
/READ-ONLY qualifier prevents you from modifying the file as you display 
it. Control characters are displayed rather than being interpreted when you 
use /READ-ONLY, however. For example, the form-feed character appears 
as <FF> rather than producing a form feed. 
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2.5.3 Creating and Modifying Files 

The most versatile interactive tool for creating and modifying files is the 
interactive editor. EVE and EDT are two such editors; VMS supports several 
others. See Chapter 8 for a description of the EVE and EDT editors. 

You can also create and modify files by using the DCL commands CREATE, 
COPY, and RENAME. The CREATE command creates a text file. You enter 
the CREATE command and then type lines of text, as shown in the following 
example: 

$ CREATE POUND.LIS 
Tag #23, Elmer Doolittle, notified 
Tag #37, James Watson, notified 
No tag, light brown, 30 lbs., looks part beagle 
|CTRL/z] 

Pressing CTRL/Z signals the end of the file and returns you to DCL command 
level. You cannot modify a file with the CREATE command. Once you have 
pressed RETURN, you cannot return to a previous line to modify a word. 

The COPY command duplicates the contents of the old file in a new file. 

The following example copies FEES.DAT to RECORDS.DAT in the default 
directory: 

$ COPY FEES.DAT RECORDS 

The COPY command can duplicate many files at a time. The following 
example copies all TXT files in the default directory to another directory: 

$ COPY *.TXT;* [SAVETEXT]*.*;* 

The COPY command can concatenate files. The following example appends 
FEES1.DAT to FEES.DAT (forming a new version of FEES.DAT) in your 
default directory: 

$ COPY FEES.DAT.FEES1.DAT FEES.DAT 

Use the COPY command to copy files from another node to your node. The 
following example copies the latest version of all files in DISK2:[PUBLIC] on 
node CHAOS to files with the same names in your default directory: 

$ COPY CHAOS::DISK2:[PUBLIC]*.* * 

Use the COPY command to copy files from your node to another node. The 
following example copies the latest version of all files in your default directory 
to files with the same names in the directory DISK2:[STAFF_BACKUP1 on 
node CHAOS: 

$ COPY *.* CHAOS::DISK2:[STAFF.BACKUP] 

If you receive a protection violation or DECnet-VAX error message when you 
attempt to copy a file across systems, you have two recourses: 

• If you own the file, you can send it to a user account on the other node 
with the Mail Utility. 

• You can follow the node name in the file specification with an access 
control string. 
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Use the /SINCE qualifier with the COPY command to select only those files 
that meet the specified criterion. The following example copies to the default 
directory only those files in the directory [JONES.LICENSES.DOG] that have 
been modified since December 31, 1988: 

$ C0PY/SINCE=31-DEC-1988/MODIFIED [JONES.LICENSES.DOG]*.* * 

Use the RENAME command to give the file a new name and optionally locate 
it in a different directory. The following example gives the file FEES.DAT the 
new name RECORDS.DAT and moves it from the default directory to another 
directory: 

$ RENAME FEES.DAT;4 [SAVETEXT]RECORDS.DAT 

Note that after being renamed, the file FEES.DAT;4 no longer exists in the 
default directory. When you use the RENAME command, the input and 
output locations must be on the same device. 


2.5.4 Deleting Files 

The DELETE command removes files from directories and releases the disk 
space they occupy for use by other files. The DELETE command requires 
you to specify a version number or the asterisk wildcard character in each file 
specification. The following example deletes version 17 of POUND.LIS: 

$ DELETE POUND.LIS;17 

The following example deletes versions 16 and 17 of POUND.LIS: 

$ DELETE POUND.LIS;16,;17 

The following example deletes all versions of POUND.LIS: 

$ DELETE POUND.LIS;* 

When you delete many files with wildcard characters, you should confirm 
each deletion by specifying the /CONFIRM qualifier, as shown in the 
following example: 

$ DELETE/CONFIRM *.*;* 

DISKI:[JONES.LICENSES.DOG]FEES.DAT;4, delete? [N]: * 

DISKI:[JONES.LICENSES.DOG]FEMALE.LIS;6, delete? [N]: 

DISKI:[JONES.LICENSES.DOG]MALE.LIS;3, delete? [N]: 

DISKI:[JONES.LICENSES.DOG]POUND.LIS;17, delete? [N]: 

Similarly, you may want to display the names of files as they are deleted. You 
can do this by specifying the /LOG qualifier with the DELETE command, as 
shown in the following example: 

$ DELETE/LOG +.LIS;* 

_'/,DELETE -1 - FILDEL, DISKI: [JONES. LICENSES. DOG] FEMALE. LIS; 6 deleted (35 blocks) 

DELETE -1 - FILDEL, DISKI: [JONES. LICENSES. DOG] MALE. LIS; 3 deleted (5 blocks) 

_ # /,DELETE-1-FILDEL, DISKI: [JONES.LICENSES.DOG]POUND.LIS; 17 deleted (9 blocks) 

The PURGE command deletes all but the latest version of the specified file 
(or all files) in the default directory or any other specified directory. Purging 
sequential files after updating them enables you to retain more free space on 
your disk volumes. 

The following example deletes all but the latest two versions of each file in 
your default directory: 

$ PURGE/KEEP=2 
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2.5.5 Printing Files 

The PRINT command places your print job (all the files to be printed) in a 
list of jobs to be printed called a print queue. Print queues can be one of the 
following types of queues: 

• Print queue—A queue assigned to a specific print device. 

• Terminal queue—A print queue assigned to a hardcopy terminal that is 
being used solely as a printer (not interactively). 

• Generic queue—A queue that distributes the processing of jobs to printers 
with similar characteristics. Jobs submitted to a generic queue are held in 
that queue until one of the assigned printer queues becomes available. 

To print a file or files, use the PRINT command. The following example 
places a print job containing three files in the default print queue, 
SYS$PRINT. 

$ PRINT POUND,MALE.FEES.DAT 

Job POUND (queue SYS$PRINT, entry 202) started on SYS$PRINT 

The file types of the files named in the PRINT command default to LIS 
or the last explicitly named file type; thus, the preceding example queues 
POUND.LIS, MALE.LIS, and FEES.DAT to SYS$PRINT. The system displays 
the job name (POUND), the queue name (SYS$PRINT), the job number 
(202), and indicates whether the job has started or is pending. By default, 
the job name is the name of the first (or only) file specification in the PRINT 
command. Once a job is submitted to a queue, you reference it using the 
job number. Once the job is queued, it will be printed when no other jobs 
precede it in the queue and when the printer is physically ready to print. 

A print queue can execute only one job at a time. Print jobs are scheduled 
for printing according to their priority, and the job with the highest priority is 
printed first. If more than one job exists with the same priority, the smallest 
job is usually printed first. Jobs of equal size having the same priority are 
selected for printing according to their submission time. 

The default print queue, SYS$PRINT, is usually initialized and started as part 
of the site-specific system startup procedures. The SHOW QUEUE command 
displays the queues that are initialized at your site. The SHOW ENTRY 
command displays the status of your print jobs, as shown in the following 
example: 

$ SHOW ENTRY 

Jobname Username Entry Blocks Status 


POUND JONES 202 38 Printing 

On printer queue SYS$PRINT 

Specify the USERNAME parameter to the SHOW ENTRY command to see 
jobs queued by other users. Use the ENTRY-NUMBER parameter to the 
DELETE/ENTRY command to delete your job from the queue, as shown in 
the following example: 

$ DELETE/ENTRY=202 
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You can print a file on another system by copying that file to the remote 
node and specifying the /REMOTE qualifier to the PRINT command. The 
following example copies the file COMPANY_HOLIDAYS.TXT from your 
local node to the remote node CHAOS and queues the file for printing to the 
default system print queue (SYS$PRINT) on node CHAOS. The asterisk at 
the end of the file specification is a wildcard character. Here, it instructs the 
system to duplicate the file name COMPANY_HOLIDAYS.TXT when that file 
is copied to the remote node. 

$ COPY COMPANY_HOLIDAYS.TXT CHAOS"JONES PANDEMONIUM"::DISK2:[JONES]* 

$ PRINT/REMOTE CHAOS::DISK2:[JONESjCOMPANY_HOLIDAYS.TXT 

In the previous example, an access control string was specified to indicate that 
you are authorized to copy files to the directory [JONES] on node CHAOS. 
However, if you have a proxy account on that remote node, the access control 
string is unnecessary. (See Section 2.4 for more information about proxy 
accounts.) 

Note that not all qualifiers to the PRINT command are compatible with the 
/REMOTE qualifier. For example, you cannot queue a job to a specific print 
queue; all jobs are queued to the default system print queue (SYS$PRINT). 
See the description of the /REMOTE qualifier to the DCL command PRINT 
in the VMS DCL Dictionary for a list of PRINT qualifiers compatible with 
/REMOTE. 

DCL Commands That Control Print Jobs 

The DCL commands listed in the following table allow you to control print 
jobs in various ways. For example, you can specify the number of copies 
printed or you can request that the system notify you when your print job 
is complete. For more information on any of these commands, see the VMS 
DCL Dictionary . 


Print Operations 

Print Job Commands and Qualifiers 

Number of copies 

By job 

PRINT/JOB_COUNT=n 

By file 

PRINT/COPIES=n 1 

Specified file only 

file-spec/COPIES^ 1 

Number of pages 

PRINT/PAGES =1 

Print features 

Flag pages 

PRINT/FLAG- 

Type of forms (paper) 

PRINT/FORIVH 1 

Special features 

PRINT/CHARACTERISTICS^ 

Double-spacing 

PRINT/SPACE 1 

Page heading 

PRINT/HEADER 1 

Notification of job execution 

PRINT/NOTIFY 

Delay execution of a job 

For a specified time 

PRINT/AFTER 

Indefinitely 

PRINT/HOLD 

Release a delayed job 

SET QUEUE/ENTRY/RELEASE 

Display your print jobs 

SHOW ENTRY 


1 Parallel qualifiers for the SET QUEUE/ENTRY command allow you to specify these 
operations for print jobs that are already queued but not yet printing. 
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Print Operations 

Print Job Commands and Qualifiers 

Stop a print job 


Delete job 

DELETE/ENTRY=job-number 

Stop currently printing 

STOP/ABORT 

job and begin printing 
the next job in the 


queue 

Stop currently printing 

STOP/REQUEUE 

job and requeue it for 
printing 



2.6 Device and Directory Operations 

To access files on your system, you need to know how to navigate through 
many directory structures. Because directories reside on devices, you also 
need to know how to work with devices other than your default device. 

Device and directory operations include the following: 

• Displaying directories 

• Creating directories 

• Deleting directories 

• Setting a default device 

• Setting a default directory 

• Searching the directory structure with wildcards 


2.6.1 Displaying Directories 

The DCL command DIRECTORY displays the names of the files in a 
directory. The following example lists the files in [JONES]: 

$ DIRECTORY/C0LUMNS=1 

Directory DISKI: [JONES] 

LICENSES.DIR;1 
LOGIN.COM;3 
LOGIN.COM;4 
STAFF.DIS;3 
STAFF.VACATIONS.TXT;2 
TAXES.DIR;1 

Total of 5 files. 

The display shows us that [JONES] contains two subdirectories— 

[JONES.LICENSES] and [JONES.TAXES]—and four nondirectory files 
STAFF.DIS, STAFF_VACATIONS.TXT, and two versions of LOGIN.COM. 
The following example (assuming that the default directory remains [JONES]) 
lists the contents of the subdirectory [JONES.LICENSES]. Note that if you 
want to move one level down the directory structure, you need specify only 
the subdirectory name, preceded by a period, to which you want to move. 
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$ DIRECT0RY/C0LUMNS=1 [.LICENSES] 

Directory DISKI:[JONES.LICENSES] 

MAILING.LIS;6 
TOTAL.DAT;2 
DEPT.DAT;3 
DOG.DIR;1 
MARRIAGE.DIR;1 

Total of 6 files. 

If you have sufficient privileges, you can display the contents of the master 
file directory. To do so, specify [000000] as the file-spec parameter to the 
DIRECTORY command or search up one level from a top level directory 
using the [-] wildcard (described in Section 2.6.6.2). Note that nine of the 
files contained in [000000] are structure files, which are special files created 
and reserved by the system that must not be deleted. Note also that your 
system disk contains several directories with files that provide data required 
to run VMS and allow you to run command images and execute command 
procedures. 

See the Guide to Setting Up a VMS System for more information about user 
privileges. 


2.6.2 Creating Directories 

The CREATE/DIRECTORY command creates a subdirectory, as shown in the 
following example. 

$ CREATE/DIRECTORY [JONES.LICENSES] 

If your current default directory is [JONES], specify the following: 

$ CREATE/DIRECTORY [.LICENSES] 

Note that you must have SYSPRV privilege to create a top level directory. 
See the Guide to Setting Up a VMS System for a discussion of user privileges. 


2.6.3 Deleting Directories 

You cannot delete a directory that contains files. Before deleting a directory or 
subdirectory, make sure it is empty by entering the DIRECTORY command, 
as shown in the following example: 

$ SET DEFAULT [JONES.LICENSES] 

$ DIRECTORY 

No files found. 

If the directory contains any files, copy or rename them to another directory 
(if you want to save them) and delete them from the directory of interest. If 
the directory contains subdirectories, examine those subdirectories (copying 
and deleting their files) and delete the subdirectories. 

To delete a directory, move to the directory one level above the directory you 
want to delete. This means that if you want to delete [JONES.LICENSES], 
you should set default to [JONES]. Remember that the subdirectory 
[JONES.LICENSES] exists as a file named LICENSES.DIR;1 in the directory 
[JONES]. You delete a directory by deleting the file that points to that 
directory. 
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Because a directory file is created without delete access to prevent accidental 
deletion of the directory, you must change the file protection to allow delete 
access before you can delete that directory file. (See Section 7.2 for more 
information about file protection.) The following example shows how to 
delete the subdirectory [JONES.LICENSES]: 

$ SET DEFAULT [JONES] 

$ SET PR0TECTI0N=0WNER:D LICENSES.DIR 
$ DELETE LICENSES.DIR;1 

The directory files (for example, JONES.DIR;l) in the master file directory 
require SYSPRV privilege to delete. See the Guide to Setting Up a VMS System 
for a discussion of user privileges. 


2.6.4 Setting a Default Directory 

Ascend and descend the directory hierarchy by setting default to a different 
directory with the DCL command SET DEFAULT. The default remains in 
effect until you enter another SET DEFAULT command. 

The following example sets default to the directory [JONES] and displays the 
file STAFF_VACATIONS.TXT: 

$ SET DEFAULT [JONES] 

$ TYPE STAFF_VACATIONS.TXT 

Subdirectories are specified by concatenating the subdirectory name to the 
name of the directory one level above it. The following example displays the 
file BILLING.DAT located in the subdirectory [JONES.TAXES]: 

$ SET DEFAULT [JONES.TAXES] 

$ TYPE BILLING.DAT 

When you move from your current default directory to a subdirectory one 
level below, you can omit the current directory's name in the file specification. 
By default, the system assumes the current directory. In the following 
example, the current default directory is [JONES]: 

$ SET DEFAULT [.TAXES] 

$ TYPE BILLING.DAT 

You can display the current default directory by entering^the command 
SHOW DEFAULT, as shown in the following example: 

$ SHOW DEFAULT 

DISKI:[JONES.TAXES] 

$ SET DEFAULT [PUBLIC] 

$ SHOW DEFAULT 
DISKI:[PUBLIC] 
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2.6.5 Setting a Default Device 

Section 2.6.4 describes how to set a default directory with the DCL command 
SET DEFAULT. You can also use the SET DEFAULT command to change 
the default device. The default remains in effect until you enter another SET 
DEFAULT command or log out. 

The following example shows how to change the default device: 

$ SHOW DEFAULT 
DISKI:[JONES] 

$ SET DEFAULT DISK2:[GROUP] 

$ SHOW DEFAULT 
DISK2: [GROUP] 

You can specify the device to which you want to set default without including 
the directory in the command. In the following example, the directory 
[JONES] is assumed and exists on DISKI and DISK2: 

$ SHOW DEFAULT 
DISKI:[JONES] 

$ SET DEFAULT DISK2: 

$ SHOW DEFAULT 
DISK2: [JONES] 

Note that VMS allows you to set default to a nonexistent disk or directory. 

If you find yourself in a nonexistent disk or directory and cannot carry out 
a desired operation, simply set default to an existing disk or directory and 
continue your task. 


2.6.6 Searching the Directory Structure with Search Wildcards 

From any point in a directory structure, you can refer to another directory or 
subdirectory in the structure. Do this by specifically naming the directory or 
subdirectory you want or by using the ellipsis (...) and hyphen (-) wildcard 
characters. 


2.6.6.1 The Ellipsis (...) Wildcard Character 

Use the ellipsis to search down into the directory hierarchy. To search 
the current directory and all the subdirectories below it, use the ellipsis by 
itself. The following command searches the current default directory and all 
subdirectories below it: 

$ DIRECTORY [...] 

Assuming the current directory is [JONES], the following command 
displays the latest versions of all files named FEES.DAT in [JONES] and 
all subdirectories under [JONES]: 

$ TYPE [JONES. . .]FEES.DAT 

If you begin the directory specification with an ellipsis, the search begins from 
your current directory. Assuming the current default directory is [JONES], 
the following command searches all subdirectories that end in .SALES and 
displays the latest versions of the file FEDERAL.LIS: 

$ TYPE [...SALES]FEDERAL.LIS 
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Assuming the current directory is [JONES], the following command 
displays the latest versions of all files named DEPT.DAT in [JONES] and 
all subdirectories under [JONES]: 

$ TYPE [...]DEPT.DAT 

However, if you begin the directory specification with a period, only the 
subdirectory that is one level lower than the current directory is searched. 
Assuming the current directory is [JONES], the following command searches 
only the [.LETTERS] subdirectory that is one level lower than [JONES] for the 
file INVITATION.TXT. The subdirectory [JONES.LETTERS] is searched, but 
[JONES.WORK.LETTERS] is not: 

$ TYPE [.LETTERS]INVITATION.TXT 

Assuming the current directory is [JONES], the following command displays 
the latest versions of all files named DEPT.DAT in the [.LICENSES] 
subdirectory under [JONES] and all subdirectories under the [.LICENSES] 
subdirectory: 

$ TYPE [.. .LICENSES. . JDEPT.DAT 

To search all top level directories and their subdirectories from wherever you 
are in the directory structure, use an asterisk (*) followed by an ellipsis (...). 
The following command (which requires READ ALL privilege) searches as 
many as eight levels of directory names (the top level directory and seven 
subdirectories), if they exist. It does not search the MFD. 

$ DIRECTORY [*...] 


2.6.6.2 The Hyphen (-) Wildcard Character 

The hyphen wildcard character permits you to move up through the directory 
structure. Each hyphen refers to the directory one level up from the current 
one. You can follow the hyphens with directory and subdirectory names to 
move down the directory structure on another path. 

If the current directory is [JONES.LICENSES], the following command 
displays the latest version of STAFF.DIS in [JONES]: 

$ TYPE [-]STAFF.DIS 

If your current directory is [JONES.LICENSES], the following command 
displays the latest version of BILLING.DAT in [JONES.TAXES]: 

$ TYPE [-.TAXES]BILLING.DAT 

You can specify more than one hyphen. The following command moves you 
up two levels in the directory hierarchy. 

$ SET DEFAULT [—] 

If you enter so many hyphens that you point above the master file directory 
(MFD), the system displays an error message. 

The following example uses the BACKUP command to copy all files in 
[JONES.TAXES] to a directory named [AUDIT], and all the files in any 
subdirectories under [JONES.TAXES] to corresponding subdirectories under 
[AUDIT]: 

$ BACKUP [JONES.TAXES...]*.*.* [AUDIT...]*.*.* 
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The trailing ellipsis in the output specification lets you move the entire 
third level directory structure from the input directory to the second level of 
the output directory. Unlike the COPY command, the BACKUP command 
preserves the input directory structure in the output it creates. 


2.6.6.3 Using Wildcards to Copy a Directory Structure 

By including asterisk (*) and ellipsis (...) wildcards in output directory 
specifications, you can do the following: 

• Duplicate an entire input directory structure 

• Move files from one directory structure into another directory structure at 
the same or at a different level 

Each wildcard character in an output directory specification refers to 
a corresponding directory level in the input specification. An output 
specification may contain only wildcards, or it may contain a combination 
of wildcards and directory names. If directory names are used, they must 
always precede any wildcards that are included. 

Use the asterisk when you want a particular level in the output directory 
specification to match a level indicated by a wildcard in the input 
specification. For example: 

$ BACKUP [JONES.*]*.*;* [SCHULTZ.SAVE.*]*.*;* 

In the previous example, the BACKUP command copies all files from any 
subdirectories under [JONES] to any corresponding subdirectories under 
[SCHULTZ.SAVE]. For example, all files in the subdirectory [JONES.TAXES] 
are copied to the subdirectory [SCHULTZ.SAVE.TAXES]. Notice that 
the single asterisk in the output directory specification refers to the first 
subdirectory level in the input directory that contained a wildcard. 

Use the ellipsis when you want the output directory specification to follow 
the same structure downwards as the input directory from the first level that 
contained a wildcard. For example: 

$ BACKUP [JONES.TAXES...]*.*;* [AUDIT...]*.*;* 

In the previous example, the BACKUP command copies all files in 
[JONES.TAXES] to a directory named [AUDIT], and all the files in all 
subdirectories under [JONES.TAXES] to corresponding subdirectories under 
[AUDIT]. The trailing ellipsis in the output specification lets you move the 
entire third level directory structure from the input directory to the second 
level of the output directory. 

For output directory specifications, a trailing asterisk and ellipsis are mutually 
exclusive when they follow a specific directory name. Therefore, output 
directory specifications such as [USER.*...] and [USER...*] are invalid. 
However, [*...] is valid, because the asterisk wildcard is used in place of a 
directory name. 

You can move an entire input directory structure to an output directory 
structure. The two ways to do this are as follows: 

$ BACKUP DISKI:[JONES...]*.*;* DISK2[*]*.*;* 

or 

$ BACKUP DISKI:[JONES...]*.*;* DISK2[*...]*.*;* 
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These commands let you move all the files in the [JONES] directory structure 
on the disk DISKI to the [JONES] directory structure on disk DISK2, from the 
top level directory down through the entire structure. 
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The environment in which you interact with the system is called a process. A 
process contains identification and status information that the system needs to 
execute programs for you. Within a process, programs execute one at a time 
in the order in which they are invoked. 

You can place your process into hibernation and create a second process 
called a subprocess under your user name. You can interact with the system 
and log out of that subprocess to return to the original process. 

A program executes within the context of the process that invokes it. Some 
programs are system programs that control the flow of events within the 
process. For example, when you log in, your process is under the control of 
the system program SYS$SYSTEM:LOGINOUT.EXE. When you work at DCL 
level, your process is under the control of SYS$SYSTEM:DCL.EXE. 

A command procedure is a file that contains a list of DCL commands. 
Complex command procedures resemble programs written in high-level 
programming languages. In this sense, command procedures provide a way 
to write programs in DCL. 

You can submit programs and command procedures for execution as batch 
jobs, which you submit to the system as separate processes. Batch jobs allow 
you to continue to work interactively with the system while the program or 
procedure executes as another process under your user name. 


3.1 Processes and the User Environment 

Each user on the system is associated with a process, which is a special 
environment created by the system that makes interaction with the system 
possible. A process has a beginning and an end; for example, the system 
creates a process for you when you log in and deletes that process when 
you log out. A process contains all the information that the system needs 
to execute programs. It is within your process that the system executes your 
programs (also called images or executable images) one at a time. 

A process can be a detached process (a process that is independent of other 
processes) or a subprocess (a process that is dependent on another process 
for its existence and resources). Your main process, also called your parent 
process, is a detached process. 

The system creates a process for you when you do one of the following: 

• Log in—The system creates a process for each interactive user. 

• Submit a batch job—The system creates a process for each batch job. 
When the batch job is completed, the system deletes the process. 
Section 3.1.4 discusses batch jobs. 

• Spawn a subprocess—The system creates a process when you use the 
SPAWN command. Section 3.1.3 describes subprocesses. 

• Run a program using either the /DETACHED or the UIC=uic qualifiers. 
Section 3.1.1 describes programs. 
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The system also creates special system processes to perform various functions. 
The DCL command SHOW SYSTEM displays both user and system processes. 


The following list summarizes the process context. Certain characteristics, 
such as the privileges, symbols, and logical names enabled in your process, 
collectively create the process context. Use the DCL command SHOW 
PROCESS/ALL to examine your process context. 

31-DEC-1988 13:30:37.12 O User: CLEAVER © 

Pid: 24E003DC © Proc. name: CLEAVER.1 © UIC: [DOC,CLEAVER] © 

Priority: 4 0 Default file spec: DISKI:[CLEAVER] O 


Process Quotas: © 

Account name: DOC 

CPU limit: Infinite Direct I/O limit: 18 

Buffered I/O byte count quota: 31808 Buffered I/O limit: 25 

Timer queue entry quota: 10 Open file quota: 57 

Paging file quota: 22276 Subprocess quota: 4 

Default page fault cluster: 64 AST quota: 38 

Enqueue quota: 600 Shared file limit: 0 

Max detached processes: 0 Max active jobs: 0 


Accounting information: 
Buffered 1/0 count: 
Direct 1/0 count: 

Page faults: 

Images activated: 
Elapsed CPU time: 
Connect time: 


© 

140 Peak working set size: 

7 Peak virtual size: 

304 Mounted volumes: 

1 

0 00:00:00.55 
0 00:00:22.76 


383 

2336 

0 


Process privileges: 
GROUP 
TMPMBX 
0PER 
NETMBX 


© 

may affect other processes in same group 
may create temporary mailbox 
operator privilege 
may create network device 


Process rights identifiers: © 

INTERACTIVE 
LOCAL 

SYS$NODE_AJAX 

Process Dynamic Memory Area 
Current Size (bytes) 

Free Space (bytes) 

Size of Largest Block 
Number of Free Blocks 

Processes in this tree: © 

CLEAVER 

CLEAVER.1 (*) 

© Current date and time—The date and time when the SHOW 
PROCESS/ALL command is executed. 

© User name—The user name assigned to the account that is associated 
with the process. 


25600 Current Total Size (pages) 50 

19592 Space in Use (bytes) 6008 

19520 Size of Smallest Block 24 

3 Free Blocks LEQU 32 Bytes 1 


© Process identification number (PID)—A unique number assigned to the 
process by the system. The SHOW PROCESS command displays the PID 
as a hexadecimal number. 


© Process name—The name assigned to the process. Since process names 
are unique, the first process logged in under an account is assigned the 
user name, and subsequent processes logged in under the same account 
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are assigned the terminal name. You can change your process name with 
the DCL command SET PROCESS/NAME. 

© User identification code (UIC)—The group and member numbers (or 
letters) assigned to the account that is associated with the process (for 
example, [PERSONNEL,RODGERS]). Part of your UIC identifies the 
group to which you belong. Within a group, users are allowed to share 
files or system resources more freely than between groups. 

© Priority—The current priority of the process. 

O Default file specification—The current device and directory. Change your 
current defaults with the DCL command SET DEFAULT. 


© Process quotas—The quotas (limits) associated with the process. Examine 
these quotas with the /QUOTAS or /ALL qualifiers of the SHOW 
PROCESS command. 

© Accounting information—The continuously updated account of the 
process's use of memory and CPU time. Examine this information 
with the /ACCOUNTING or /ALL qualifiers of the SHOW PROCESS 
command. 

© Process privileges—The privileges granted to your processes. Privileges 
restrict the performance of certain system activities to certain users. 
Examine your privileges with the /PRIVILEGES or /ALL qualifiers of the 
SHOW PROCESS command. 

® Process rights identifiers—System-defined identifiers that are used in 
conjunction with access control list protection. Identifiers provide the 
means of specifying the users in an access control list. An access control 
list is a security tool that defines the kinds of access to be granted or 
denied to users of an object, such as a file, device, or mailbox. (See 
Chapter 7 for more information about identifiers and access control lists.) 

© Process dynamic memory area—The process's current use of dynamic 
memory. Dynamic memory is allocated by the system to an image 
when that image is executing. When that memory is no longer needed 
by one process, the system allocates it to another process. Examine 
this information with the /MEMORY or /ALL qualifiers of the SHOW 
PROCESS command. 

© Processes in this tree—A list of subprocesses belonging to the parent 
process. An asterisk appears after the current process. Examine this with 
the DCL SHOW PROCESS/SUBPROCESSES or /ALL command. 


3.1.1 Programs 

A program, also called an image or executable image, is a file that contains 
instructions and data in machine-readable format. Image files can be VMS- 
or user-supplied and usually have a file type of EXE. You cannot examine an 
image file with the DCL commands TYPE, PRINT, or EDIT because image 
files do not consist of ASCII characters. (Text files contain ASCII characters, 
which are a standard method of representing the alphabet, punctuation 
marks, numerals, and other special symbols.) 



3-3 











Working with Processes 

3.1 Processes and the User Environment 


A program can be either a command image or a noncommand image as 
follows: 

• Command image—A command image is a program associated 
with and invoked by a DCL command. For example, when you 
type the DCL command COPY, the system executes the program 
SYS$SYSTEM:COPY.EXE. COPY.EXE is a command image. A system 
directory named SYS$SYSTEM contains a number of command image 
files, most of which are VMS-supplied. Use the DCL command 
DIRECTORY SYS$SYSTEM to examine this system directory. 

• Noncommand image—A noncommand image is a program not associated 
with a DCL command. To invoke a noncommand image, name the file 
containing the program as the parameter to the RUN command. 

Executing Programs Across the Network 

Because of support provided by DECnet-VAX, programs can execute across 
the network as if they were executing locally. Because DECnet-VAX is 
integrated within the VMS operating system, it is easy to write programs that 
access remote files. To access a remote file in an application program, you 
need only include in your file specification the name of the remote node and 
any required access control information. 

Task-to-task communications, a feature common to all DECnet 
implementations, allows two application programs running on the same 
or different operating systems to communicate with each other regardless 
of the programming languages used. Examples of network applications are 
distributed processing applications, transaction processing applications, and 
applications providing connection to servers. 


3.1.2 Command Procedures 

A command procedure is a file that contains a list of DCL commands. 

When you execute a command procedure, DCL reads the command file and 
executes the commands it contains. Command procedures can be executed as 
interactive or batch processes. If you use command procedures that require 
lengthy processing time (for example, the compilation or assembly of large 
programs) submit these procedures as batch jobs so you can continue to use 
your terminal interactively. 

When you submit a command procedure for batch execution, the system 
creates a detached process using your account and process characteristics. 

The system runs the job from that process and deletes the process when the 
job is completed. 

You can use command procedures to automate sequences of commands that 
you enter frequently. For example, if you always examine the contents of a 
directory immediately after setting default to it, you can design a command 
procedure that issues the appropriate commands to display the directory's 
contents. A command procedure might contain the following commands 
to set default to the ACCOUNT subdirectory and display the subdirectory's 
contents. (Exclamation points delimit comments in command procedures; 
DCL ignores everything to the right of the exclamation point when processing 
the line.) 
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$ ! DISKI:[ADAMS]ACCOUNTD.COM 
$ ! 

$ SET DEFAULT DISKI:[ADAMS.ACCOUNT] 

$ DIRECTORY 

To execute a command procedure interactively, type the @ command 
followed by the procedure's file specification. To execute the command 
procedure in the previous example, enter @DISKl:[ADAMS]ACCOUNTD 
(or @ACCOUNTD if your current disk and directory are DISK1:[ADAMS]). 

Chapter 6 discusses command procedures in greater detail. 


3.1.3 Subprocesses 

The SPAWN command enables you to create a subprocess of your current 
process. Within this subprocess, you can interact with the system and log out 
of the subprocess to return to your parent process, or switch between your 
parent process and subprocesses. Only one of your processes is executing at 
any time. 

Each user on the system is represented by a job tree. A job tree is a hierarchy 
of all your processes and subprocesses, with your main process at the top. A 
subprocess is dependent on the parent process and is deleted when the parent 
process exits. By default, the subprocess assumes the name of the parent 
process followed by an underscore and a unique number. For example, 
if the parent process name is DOUGLASS, the subprocesses are named 
DOUGLASS—l, DOUGLASS—2, and so on, forming a tree of subprocesses. 

Typically, you use a subprocess in one of the following two ways: 

• To interrupt a task, perform a second task, then return to the original 
task—Because SPAWN is a built-in command (listed in Chapter 1), you 
can use CTRL/Y to interrupt one task, spawn a subprocess to perform 
a second task, exit from the subprocess, and then enter the CONTINUE 
command to return to the original task. By default, when you create a 
subprocess, the parent process hibernates, and you are given control at 
DCL level within the subprocess. Your default directory is the current 
directory of the parent process. (If you interrupt the EDT editor, enter the 
CONTINUE command and press CTRL/W to refresh the screen.) 

• To perform a second task while continuing to work on your original 
task—You can do so by creating the subprocess with the 
SPAWN/NO WAIT command. Use the SPAWN/NO WAIT command 
only to execute commands that do not require input; SPAWN/NOWAIT 
generates a noninteractive, batch-like subprocess. 

Because both the parent and the subprocess are executing concurrently, 
both attempt to control the terminal. To prevent conflicts, also specify the 
following: 

- /OUTPUT qualifier—Indicates that the subprocess should write 
output to a specified file rather than to the terminal. 

SPAWN command parameter or /INPUT qualifier—Indicates that 
the subprocess should execute the specified commands rather than 
reading input from the terminal. 
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When you specify the /INPUT qualifier of the SPAWN command, 
the subprocess is created as a noninteractive process that exits upon 
encountering a severe error or an end-of-file indicator. At DCL level, 
CTRL/Z is treated as an end-of-file indicator. 

In the following example, a command image (the TYPE command) is 
interrupted with CTRL/Y and a subprocess is spawned: 

$ TYPE MICE.TXT 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 


|CTRL/Y| 

$ SPAWN 

# /,DCL-S-SPAWNED, process D0UGLASS_1 spawned 
# /,DCL-S-ATTACHED, terminal now attached to process D0UGLASS_1 
$ MAIL 
MAIL> 


MAIL> EXIT 
$ LOGOUT 

Process DOUGLASS.l logged out at 31-DEC-1988 12:42:12.46 
# /,DCL-S-RETURNED, control returned to process DOUGLASS 
$ CONTINUE 

Once inside, they may gnaw through electrical wires and raid 
your food. Because mice reproduce so quickly, what started 
as one or two mice can quickly become an invasion. If you seal 
the cracks and holes on the exterior of your foundation, you can 
prevent these rodents from ever getting in. 

Because each process you create is unique, commands executed in one 
process do not usually affect any other process. However, because control 
of the terminal passes between processes, commands that affect the terminal 
characteristics (for example, SET TERMINAL) affect any process controlling 
that terminal. For example, if one process inhibits echoing and exits without 
restoring it, echoing remains inhibited for the next process that gains control 
of the terminal. Reset any altered terminal characteristics with the SET 
TERMINAL command. 


3.1.3.1 Exiting from a Subprocess 

To exit from a subprocess created by SPAWN, use one of the following 

commands: 

• LOGOUT—When you exit from a subprocess with the LOGOUT 
command, the subprocess is deleted (along with any subprocesses that it 
created), and you are returned to the parent process. 

• ATTACH—When you exit from a subprocess with the ATTACH 
command, the subprocess hibernates, and control of your terminal 
is transferred to the specified process. (You must specify either a 
process name as a parameter to the ATTACH command or a process 
identification number (PID) as a value of the /IDENTIFIER qualifier of 
the ATTACH command.) The following example shows how to exit from 
the subprocess DOUGLASS—l and attach to the process DOUGLASS: 
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$ ATTACH DOUGLASS 

•/.DCL-S-RETURNED, control returned to process DOUGLASS 
$ SHOW PROCESS 

26-APR-1988 10:34:58.50 VTA303 User: DOUGLASS 

Pid: 25C002B4 Proc. name: DOUGLASS UIC: [200.200] 

Priority: 4 Default file spec: SYS$SYSDEVICE:[DOUGLASS] 

Devices allocated: $11$VTA303: 


3.1.3.2 Subprocess Context 

By default, a subprocess inherits the following items from the parent process: 
defaults, privileges, symbols, logical names, control characters, message 
format, verification state, and key definitions. The environment that these 
items collectively create is called the process context. The following items, 
however, are not inherited from the parent process: 

• Process identification number (PID)—The system assigns each created 
subprocess a unique process identification number. 

• Process name—By default, the subprocess name consists of the name of 
the parent process followed by an underscore and an integer. Use the 
/PROCESS qualifier of the SPAWN command to specify a process name 
other than the default. A process name must be unique. 

• Created commands—Commands that are defined by a parent process 
using the SET COMMAND command are not copied to a subprocess. To 
use a created command in a subprocess, you must use SET COMMAND 
to create that command for the subprocess. 

• Authorize privileges—When you spawn to a subprocess, the process 
context contains the privileges currently enabled, not the privileges 
that you may be authorized to enable. For example, if you spawn to a 
subprocess while in MAIL and want to perform a privileged operation, 
you need to have already set the proper privilege in the parent process. 

You can use the following SPAWN qualifiers to prevent the subprocess from 
inheriting a number of these items: 


Qualifier 

Items Inhibited or Changed 

/CARRIAGE-CONTROL, /PROMPT 

DCL prompt 

/NOCLI 

CLI (command language interpreter; 

DCL by default) 

/NOKEYPAD 

Keypad definitions 

/NOLOGICAL_NAMES 

Logical names 

/NOSYMBOL 

Symbols 


The /SYMBOL and /LOGICAL—NAMES qualifiers do not affect system- 
defined symbols (such as $SEVERITY and $STATUS) or system-defined 
logical names (such as SYS$COMMAND and SYS$OUTPUT). Symbols are 
described in Chapter 5. See Chapter 4 for more information about logical 
names. 
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Since copying logical names and symbols to a subprocess can be time- 
consuming (a few seconds), you may want to use the 
/NOLOGICAL -NAMES and /NOSYMBOL qualifiers to the SPAWN 
command unless you plan to use the logical names or symbols in the 
subprocess. If you use subprocesses frequently, the ATTACH command 
provides the most efficient way to enter and exit a subprocess. This method 
allows you to transfer control quickly between the parent process and 
subprocess rather than repeatedly waiting for the system to create a new 
subprocess for you. 


3.1.4 Batch Jobs 

Usually you use VMS in interactive mode. When you work interactively with 
VMS, the system must expend resources waiting for your input. If the system 
is heavily loaded with other jobs, your interaction with VMS is slowed. Also, 
when you run a long job interactively, your terminal is unavailable to you 
until the job is completed. 

A batch job consists of one or more programs or command procedures that 
execute as a detached process without user interaction. A batch job allows 
you to use your terminal for other work while the system executes your 
program or command procedure. 

When you submit a batch job, the system logs in under your user name and 
creates a detached process dedicated to executing the commands in that file. 

A batch job is also more efficient than an interactive session: it runs under 
a lower priority and can be run at times when the system is not overloaded 
with interactive users. 


3.1.5 Submitting a Batch Job 

To run a job in batch mode, submit your job to a batch queue (a list of batch 
jobs waiting to execute) by entering the DCL command SUBMIT. When you 
submit a job, it is directed to the default batch queue, SYS$BATCH, where it 
is added to the end of the queue of jobs waiting to be executed. When the 
jobs preceding yours are completed, your job is executed. (On a VMS system, 
the number of batch jobs that can execute simultaneously is specified when 
the batch queue is created by the system manager.) 

By default, the SUBMIT command uses a file type of COM. The following 
command enters JOBl.COM into SYS$BATCH: 

$ SUBMIT J0B1 

Job J0B1 (queue SYSSBATCH, entry 651, started on SYS$BATCH) 

The system displays the name of the job, the queue containing the job, and 
the entry number assigned to the job. You receive the DCL prompt once your 
job is submitted to the batch queue. If you need to reference your batch job 
in any DCL commands (DELETE/ENTRY, for example), do so by using the 
job entry number. (You can obtain the job entry number by using the SHOW 
ENTRY command.) Note that if multiple procedures are submitted in a batch 
job, the batch job terminates when any procedure exits with an error or fatal 
error status. 
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Your batch job does not necessarily have to start running at the time you 
submit it to the batch queue. To specify a different time, enter the 
SUBMIT/AFTER command. In the following example, the job is submitted 
after 11:30 p.m.: 

$ SUBMIT/AFTER=23:30 J0B1.C0M 


3.1.6 Batch Job Output 

By default, accumulated output from a batch job is written to a log file once 
each minute. (To specify a different time interval, include the SET 
OUTPUT-RATE command in your command procedure.) If you attempt to 
use the EDT editor to read the log He while the system is writing to it, you 
receive a message indicating that the file is locked by another user. Wait a 
few seconds and try again. The EVE editor, however, allows you to read the 
batch job's log file. By specifying EDIT/TPU/READ—ONLY and the name 
of the log file, you can use EVE commands to move around the log file and 
ensure that any changes you make to the file are not saved. If you omit the 
/READ-ONLY qualifier and modify the log file in any way, the batch job 
terminates. 

Because your batch job is a process that logs in under your user name and 
executes your login command procedure, the output from a batch job includes 
the contents of your login command procedure. The output also includes 
everything written to the batch job log file (command procedure output, 
error messages, and so on) and the full logout message. To prevent your 
login command procedure from being written to the batch log file, add the 
following command to the beginning of your login command procedure: 

$ IF F$M0DE() .EQS. "BATCH" THEN SET NOVERIFY 

By default, the log file name is the name under which you submitted the 
job. Also by default, the log file has a file type of LOG and assumes the 
device and directory specified by your login defaults. To specify a different 
log file name when you submit the job, use the /LOG—NAME qualifier to 
the SUBMIT command. 

When the batch job completes, the log file is queued to the default system 
printer (SYS$PRINT), printed, and deleted. To save the log file after printing 
it, use the /KEEP qualifier to the SUBMIT command. To save the log file 
without printing it, use the /NOPRINT qualifier to the SUBMIT command. 


3.1.7 Restarting Batch Jobs 

If the system fails while your batch job is executing, your job does not 
complete. When the system recovers and the queue is restarted, your job is 
aborted, and the next job in the queue is executed. However, by specifying 
the /RESTART qualifier when you submit a batch job, you indicate that 
the system should reexecute your job if the system crashes before the job is 
finished. 

By default, a batch job is reexecuted beginning with the first line. See 
Section 6.10 for more information about symbols you can add to your 
command procedures to specify a different restarting point. 
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When you define a logical name, you equate one character string to an 
equivalence name, which is usually a full or partial file specification, another 
logical name, or any other character string. Once you have equated a logical 
name to one or more equivalence names, you can use the logical name to 
refer to those equivalence names. For example, you might assign a logical 
name to your default disk and directory. Logical names serve two main 
functions: 

• Shorthand and readability—You can define commonly used files, 
directories, and devices with short, meaningful logical names. Such 
names are easier to remember and type than the full file specifications. 
Names that you use frequently can be defined in your login command 
procedure. Names that most users on your system use frequently can be 
defined by a system manager in the site-specific system startup command 
procedure. 

• File independence—You can use logical names to keep your programs 
and command procedures independent of physical file specifications. 

For example, if a command procedure references the logical name 
ACCOUNTS, you can equate ACCOUNTS to any file on any disk before 
executing the command procedure. 

Logical names can be defined by you or by the system. Logical names and 
their definitions are kept in tables called logical name tables. The system 
provides the following logical name tables: 

• Your process table 

• The job table for your process 

• Your group table 

• The system table 

When you enter a logical name as part of a command line, the system 
translates the logical name. It does this by searching the logical name tables 
in a certain order. Information about existing logical name tables and the 
order in which they are searched is stored in two logical name directory tables. 

With DCL, you can also apply special attributes to logical names and define 
the order in which logical names tables are searched. 
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4.1 Creating Logical Names 

You can create your own logical names with either the ASSIGN or the 
DEFINE command. This section uses the DEFINE command to create logical 
names. (Note that the syntax for the ASSIGN command differs from the 
syntax for the DEFINE command. For information on using the ASSIGN 
command, see the VMS DCL Dictionary.) 

The syntax for defining a logical name is as follows: 

DEFINE logical-name equivalence-name[,...] 

The following example associates the logical name ACCOUNTS with the 
equivalence name DISKl:[JONES.ACCOUNTS]: 

$ DEFINE ACCOUNTS DISKI:[JONES.ACCOUNTS] 

Now you can use ACCOUNTS to refer to the directory 
DISKI :[JONES. ACCOUNTS], 

Observe the following rules when creating a logical name with the DEFINE 
command: 

• A logical name and its equivalence name can each have a maximum of 
255 characters. A logical name can contain alphanumeric characters, as 
well as the underscore (_), dollar sign ($), and hyphen (-). 

• The equivalence name must include the punctuation marks (colons, 
brackets, periods) that would be required if it were part of a file 
specification. For example, a device name is terminated by a colon, a 
directory specification is enclosed in square brackets, and a file type is 
preceded by a period. 

• You can optionally terminate a logical name with a colon. If you do this, 
the ASSIGN command removes the colon before placing the logical name 
in a logical name table. The DEFINE command does not remove the 
colon before placing the name in a logical name table. 

In general, you should not specify a colon at the end of a logical name 
when you are creating it. However, if you do so and want to save the 
colon as part of the logical name, use the DEFINE command. (Note 
that when you delete a logical name ending with a colon, you need to 
specify two colons because the DEASSIGN command, like the ASSIGN 
command, removes one colon before it searches the logical name table for 
a match.) 

If the logical name is part of a file specification, the logical name must be 
the leftmost component of the file specification and must be separated from 
the rest of the file specification by a colon. When you use a logical name to 
represent a complete file specification, the terminating colon is not needed. 
The following examples all display the file 
DISKI :[SALES_STAFF]PAYROLL.DAT: 
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$ DEFINE PAY DISKI:[SALES.STAFF]PAYROLL.DAT 
$ TYPE PAY 

$ DEFINE PAY.FILE DISKI:[SALES.STAFF]PAYROLL 
$ TYPE PAY.FILE: DAT 

$ DEFINE PAY_DIR DISKI:[SALES.STAFF] 

$ TYPE PAY.DIR:PAYROLL.DAT 

$ DEFINE PAY.DISK DISKI: 

$ TYPE PAY.DISK:[SALES.STAFF]PAYROLL.DAT 

Note that if you combine a logical name with only an explicitly stated file type 
or version number, you must include the period or semicolon, respectively. 
For example, if PAY is equivalent to DUA1:[S ALES_STAFFjPAYROLL.DAT, 
PAY:2 is an invalid file specification. (PAY:;2 is valid.) Defaults for the 
current directory, the file type (depending on the function being performed), 
and the version number are applied as usual after translation. 

By default, the DEFINE command places logical names in your process logical 
name table, where the logical name is available only to your process and 
subprocesses. Section 4.2 describes logical name tables. 

You can equate more than one logical name with an equivalence name. For 
example, you can equate the logical names $TERMINAL and CONSOLE to 
the physical name of a terminal so that both logical names translate to the 
same device. (If you equate a logical name to more than one equivalence 
string in a single command, you create a search list for the system to use 
to translate the names. See Section 4.7 for information about search list 
translation.) 

If you equate a logical name to one equivalence string and then equate 
the same logical name to another equivalence string, the second definition 
supersedes the first. You can, however, equate the same logical name to 
different equivalence strings if the logical name definitions are in different 
tables (described in Section 4.2). You can equate the same logical name to 
different equivalence strings in the same table if they are defined in different 
access modes (described in Section 4.5). 

If you cannot access a file, and the command you are specifying and the 
file specification seem in order, check the left-hand component of the file 
specification (with SHOW LOGICAL) to be sure that it is not defined as a 
logical name. 


4.1.1 Displaying Logical Names 

Display the definition of a logical name with either the SHOW LOGICAL or 
SHOW TRANSLATION command. 

When you enter the SHOW LOGICAL command, the system searches the 
process, job, group, and system logical name tables (in that order) for the 
specified logical name. In the following example, the system found the logical 
name ACCOUNTS in both the process and job logical name tables: 

$ SHOW LOGICAL ACCOUNTS 

"ACCOUNTS" = "DISKI:[ACCOUNTS]" (LNM$PROCESS_TABLE) 

"ACCOUNTS" = "DISKI:[ACCOUNTS]" (LNM$J0B_80891AE0) 
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Sometimes the definition of a logical name may include another logical name. 
The SHOW LOGICAL command continues to search the logical name tables 
until all levels of logical names in a definition have been found. This is 
referred to as iterative translation. 

When iterative translation is performed, the SHOW LOGICAL command 
displays multiple lines. Each line has a number that shows the level of 
translation. For example: 

$ SHOW LOGICAL MYDISK 

"MYDISK" = "DISK2" (LNM$PROCESS_TABLE) 

1 "DISK2 M = "$11$DUA4:" (LNM$SYSTEM_TABLE) 

Level numbers are zero based; that is, 0 is the first level, 1 is the second, 
and so on. In the previous example, two translations were performed. The 
number 1 indicates the second level of translation. See Section 4.4.1 for more 
information about iterative translation. 

Unless you have redefined the search order, you can display the contents 
of the process, job, group, and system logical name tables by entering the 
SHOW LOGICAL command without qualifiers or parameters. The following 
command displays the logical names and their definitions in all four tables: 

$ SHOW LOGICAL 

When you enter the SHOW TRANSLATION command, the system searches 
the process, job, group, and system logical name tables for the specified 
logical name. It displays the first definition it finds as well as the table in 
which it was found. In the following example, you see that the logical name 
ACCOUNTS is translated as DISKl:[ACCOUNTS] and exists in the process 
logical name table (LNM$PROCESS_TABLE): 

$ SHOW TRANSLATION ACCOUNTS 
"ACCOUNTS" = "DISKI: [ACCOUNTS]" (LNM$PROCESS_TABLE) 

Some commands and lexical functions do not translate logical names 
iteratively. The SHOW TRANSLATION command, for example, provides 
only the immediate equivalence name, as shown in the following example: 

$ DEFINE SALES.DISK WORKDISK: 

$ DEFINE SALES SALES.DISK 

$ SHOW TRANSLATION SALES 

SALES = "SALES.DISK" (LNM$PROCESS_TABLE) 

Although the SHOW LOGICAL and SHOW TRANSLATION commands 
both translate logical names, certain circumstances argue for the use of one 
command over the other, as follows: 

• To ensure that all levels of logical name translation are performed, specify 
the SHOW LOGICAL command. If you are certain that a logical name 
does not require iterative translation, specify the SHOW TRANSLATION 
command. 

• Because the SHOW TRANSLATION command is a built-in command, 
you can interrupt an image (with CTRL/Y, for example) and enter SHOW 
TRANSLATION without causing the interrupted image to exit. (Built-in 
commands are described in Section 1.2.) If you interrupt an image with 
the SHOW LOGICAL command, your interrupted image is forced to exit. 
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4.1.2 Deleting Logical Names 

To delete a logical name defined interactively, use the DEASSIGN command. 
For example: 

$ DEFINE STAFF [JONES.STAFF] 


$ DEASSIGN STAFF 

Logical names in your process and job tables are automatically deleted when 
your process terminates. However, by specifying the /USER_MODE qualifier 
to the DEFINE command, you can place a logical name in the process logical 
name table and execute one command image before the logical name is 
deleted. 


4.2 Logical Name Tables 

The system stores logical names and their equivalence strings in four logical 
name tables called process, job, system, and group. Some logical name tables 
are available only to your process; these tables are called process-private. 
Other tables are shareable; that is, they are available to other users on the 
system. 

Identical logical names can exist in more than one table. The logical name 
that is used depends on the order in which the logical name tables are 
searched. For example, when the system attempts to translate a logical name 
in order to identify the location of a file, it uses the logical name 
LNM$FILE_DEV to provide the list of tables in which to look for the name. 
The order in which the tables are listed is also the order in which they are 
searched. The precedence order defined by LNM$FILE_DEV is: (1) process 
table, (2) job table, (3) group table, (4) system table. Therefore, if a logical 
name exists in both the process and the group logical name tables, the logical 
name within the process table is used. See Section 4.3.2 for more information 
about LNM$FILE _DEV. 

Within each table, the system defines some logical names for you. Each table 
and its system-defined logical names are described in the following sections. 


4.2.1 The Process Table 

Your process logical name table, named LNM$PROCESS_TABLE, contains 
logical names that are available only to your process and any subsequent 
subprocesses. Use the logical name LNM$PROCESS to refer to the process 
table. 

Process logical names are recognized by the process they were created in and 
by any subsequent subprocesses. However, process logical names are not 
recognized by any parent process. 

To display the logical names in your process table, use the following 
command: 

$ SHOW LOGICAL/PROCESS 

You can also specify the SHOW LOGICAL/TABLE=table_name command to 
display the contents of any logical name table. 
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By default, the DEFINE and DEASSIGN commands place names in and delete 
names from your process table. 

Every process on the system has a process logical name table. When you log 
in, the system creates logical names for your process and places them in your 
process table. These names are listed in Table 4-1. 


Table 4—1 Default Process Logical Names 


Logical Name 

Description 

SYS$COMMAND 

The initial file (usually your terminal) from which DCL 
reads input. (A file from which DCL reads input is 
called an input stream.) The command interpreter uses 
SYS$COMMAND to "remember" the original input 
stream. 

SYS$DISK 

Default device established at login or changed by the 
SET DEFAULT command. 

SYS$ERROR 

The default device or file to which DCL writes error 
messages generated by warnings, errors, and severe 
errors. 

SYS$INPUT 

The default file from which DCL reads input. 

SYS$NET 

The source process that invokes a target process 
in DECnet-VAX task-to-task communication. When 
opened by the target process, SYS$NET represents 
the logical link over which that process can exchange 
data with its partner. SYSSNET is defined only during 
task-to-task communication. 

SYS$OUTPUT 

The default file (usually your terminal) to which DCL 
writes output. (A file to which DCL writes output is 
called an output stream.) 

TT 

Default device name for terminals. 


Note that the logical names SYS$INPUT, SYS$OUTPUT, SYS$ERROR, and 
SYS$COMMAND refer to files that remain open for the life of the process. 
They are referred to as process-permanent files. For more information on 
process-permanent files, see Section 4.9.1. 


4.2.2 The Job Table 

Your job logical name table contains logical names that are available to all 
processes in your job tree, no matter what process or subprocess you are 
currently in. Your job table is named LNM$JOB_xxx, where xxx is the Job 
Information Block address (defined by the system) for your job tree. Use the 
logical name LNM$JOB to refer to your job table. 

When you log in, the system creates certain logical names and places them in 
the job logical name table. These names are listed in Table 4-2. In addition, 
the logical names created for mounted disks and tapes and temporary 
mailboxes are also placed in the job logical name table. 
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Table 4-2 Default Job Logical Names 


Logical Name 


Description 


SYSSLOGIN 

SYS$LOGIN_DEVICE 

SYS$REM_ID 


For jobs initiated through a DECnet network 
connection, the identification of the process on the 
remote node from which the job was originated. On 
VMS operating systems, if proxy logins are enabled, 
this identification is the process's user name, or, 
if proxy logins are not enabled, this is the process 
identification number (PID). For more information about 
proxy logins, see the Guide to VMS System Security. 

For jobs initiated through a DECnet network 
connection, the name of the remote node from which 
the job was originated. 


Your default device and directory when you log in. 


Your default device when you log in. 


SYS$REM_NODE 


SYS$SCRATCH 


Default device and directory to which temporary files 
are written. 


There is one job table for each job tree in the system. All job tables are 
shareable so that all users may access them. However, to access a job logical 
name table other than your own, you must redefine LNM$JOB in your 
process directory logical name table. For more information about LNM$JOB, 
see Section 4.3. 


4.2.3 The Group Table 


The group logical name table contains logical names that are available to all 
users with the same user identification code (UIC) group number. The group 
table is named LNM$GROUP_xxx, where xxx represents your UIC group 
number. Use the logical name LNM$GROUP to refer to your group table. 
Every group on the system has a corresponding group logical name table. 

To create or delete a name in your group table, you need GRPNAM, 
GRPPRV, or SYSPRV privilege. See the Guide to Setting Up a VMS System for 
a description of user privileges. 


4.2.4 The System Table 


The system logical name table contains logical names that are available to all 
users on the system. The system table is named LNM$SYSTEM_TABLE; use 
the logical name LNM$SYSTEM to refer to it. To create or delete a name in 
the system table, you must have a UIC group number between 0 and 10, or 
SYSNAM or SYSPRV privilege. 

There is only one system logical name table for the system. It contains the 
names shown in Table 4-3. 
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Table 4-3 Default System Logical Names 


Logical Name 

Description 

DBG$INPUT 

Default input stream for the VMS Debugger; 
equated to SYS$INPUT 

DBG$OUTPUT 

Default output stream for the VMS Debugger; 
equated to SYS$OUTPUT 

SYS$COMMON 

Device and directory name for the common 
part of SYSSSYSROOT 

SYSSERRORLOG 

Device and directory name of error log data 
files 

SYS$EXAMPLES 

Device and directory name of system 
examples 

SYS$HELP 

Device and directory name of system HELP 
files 

SYS$INSTRUCTION 

Device and directory name of system 
instruction data files 

SYS$LIBRARY 

Device and directory name of system libraries 

SYS$LOADABLE—IMAGES 

Device and directory of operating system 
executive loadable images, device drivers, 
and other executive loaded code 

SYSSMAINTENANCE 

Device and directory name of system 
maintenance files 

SYSSMANAGER 

Device and directory name of system 
manager files 

SYSSMESSAGE 

Device and directory name of system 
message files 

SYSSNODE 

Network node name for the local system if 
DECnet-VAX is active on the system 

SYSSSHARE 

Device and directory name of system 
shareable images 

SYSSSPECIFIC 

Device and directory name for node-specific 
part of SYSSSYSDEVICE 

SYSSSTARTUP 

Device and directory name of system startup 
files 

SYSSSYSDEVICE 

VMS system disk containing system 
directories 

SYSSSYSROOT 

Device and root directory for system 
directories 

SYSSSYSTEM 

Device and directory of operating system 
programs and procedures 

SYSSTEST 

Device and directory name of User 
Environment Test Package (UETP) files 

SYSSUPDATE 

Device and directory name of system update 
files 
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4.3 Directory Logical Name Tables 


The system provides the following two directory tables to catalog your logical 
name tables: 

• LNM$PROCESS_DIRECTORY catalogs your process tables 
(LNM$PROCESS and LNM$JOB). 

• LNM$SYSTEM_DIRECTORY catalogs your shareable tables 
(LNM$GROUP and LNM$SYSTEM). 

Both of these directories contain logical names that translate iteratively to 
table names. The name of a logical name table must be recorded in one of 
these directory tables in order for the system to find it. 

You can see the relationship of directory tables to logical name tables with 
the SHOW LOGICAL/STRUCTURE command, as shown in the following 
example: 

$ SHOW LOGICAL/STRUCTURE 
(LNM$PROCESS_DIRECTORY) 

(LNM$PROCESS_TABLE) 

(LNM$SYSTEM_DIRECTORY) 

(LNM$GR0UP_000360) 

(LNM$J0B_806E98E0) 

(LNM$SYSTEM_TABLE) 


4.3.1 The Process Directory Table 


Each process on the system has its own process directory logical name table. 
When you log in, the VMS operating system places certain logical names in 
your process directory table. These names are listed in Table 4-4. 

Table 4-4 Default Process Directory Logical Names 


Logical Name 


Description 


LNM$GROUP 


A logical name that is defined as 
LNM$GROUP_xxx, where xxx represents 
your group number. LNM$GROUP_xxx is 
the logical name table used by your UIC 
group. (The table LNM$GROUP_xxx is 
cataloged in the system directory table.) 
Therefore, LNM$GROUP is a logical name 
that translates iteratively to the name of 
your group logical name table. 


LNM$JOB 


A logical name that is defined as 
LNM$JOB_xxx, where xxx represents a 
number unique to your job tree. 
LNM$JOB_xxx is the logical name table 
used by your job. (The table LNM$JOB_xxx 
is cataloged in the system directory table.) 
Therefore, LNM$JOB is a logical name that 
translates iteratively to the name of your job 
logical name table. 
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Table 4—4 (Cont.) Default Process Directory Logical Names 


Logical Name 

Description 

LNM$PROCESS 

A logical name that translates iteratively to 
LNM$PROCESS_TABLE, which is the name 


of your process logical name table. 

LNM$PROCESS_DIRECT ORY 

The name of your process directory logical 
name table. 

LNM$PROCESS_T ABLE 

The name of your process logical name 
table. 


4.3.2 The System Directory Table 

There is one system directory logical name table. The VMS operating system 
places certain logical names in the system directory table. These names are 
listed in Table 4-5. 


Table 4-5 Default System Directory Logical Names 

Logical Name Description 


LNM$DCI_LOGICAL 


LNM$DIRECTORIES 

LNM$FILE_DEV 


LNM$GROUP_xxx 


LNM$JOB_xxx 


A logical name that is defined as 
LNM$FILE_DEV. This logical name 
iteratively translates into the list of logical 
name tables searched and displayed by the 
SHOW LOGICAL and SHOW TRANSLATION 
commands and the F$TRNLNM lexical 
function. By default, these commands 
search and display the process, job, group, 
and system logical name tables, in that 
order. 

A logical name that is defined as 
LNM$PROCESS_DIRECTORY and 
LNM$SYSTEM_DIRECTORY. 

A logical name that is defined as the 
list of logical name tables searched 
by the system when processing a file 
specification. By default, it is defined as 
LNM$PROCESS, LNM$JOB, LNM$GROUP, 
and LNMSSYSTEM. This means that the 
process, job, group, and system logical 
name tables are searched, in that order. 

The name of a group logical name table, 
where xxx is a group number. There is an 
LNM$GROUP_xxx logical name table for 
each group in the system. 

The name of a job logical name table, 
where xxx is a number unique to this job 
tree. There is an LNM$JOB_xxx logical 
name table for each job in the system. 
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Table 4-5 (Cont.) Default System Directory Logical Names 


Logical Name 

Description 

LNM$SYSTEM 

A logical name that translates iteratively to 
LNM$SYSTEM_TABLE, which is the name 


of the system logical name table. 

LNN$SYSTEM -DIRECTORY 

The name of the system directory logical 
name table. 

LNM$SYSTEM_T ABLE 

The name of the system logical name table. 


Generally, you do not need to change the default logical name table 
definitions set up in the directory tables, LNM$PROCESS_DIRECTORY 
and LNM$SYSTEM_JDIRECTORY. Two reasons for changing the entries in 
the directory tables are: (1) to create another logical name table, and 
(2) to change the search order for file specification logical names by redefining 
LNM$FILE_DEV. See Section 4.6 for information about creating your own 
logical name table and changing the order in which the system searches the 
logical name tables. 

Multiple tables with the same name may exist. For example, there may exist 
both a process-private and a shareable table called MY_TABLE. The process- 
private version always takes precedence over the shareable table in all logical 
name table processing. When a logical name, such as LNM$FILE_DEV, is 
used as a table name, the logical name is iteratively translated until a list of 
table names is formed. During this iterative translation, each name is first 
translated in the process directory. If this translation fails, it is then translated 
in the system directory. This order of precedence cannot be changed. As a 
consequence of this ordering, a logical name placed in the process directory 
table for use as a table name will always take precedence over any identical 
name residing in the system directory. 


4.4 Logical Name Translation 

When the system reads a file specification or device name in a DCL command 
line, it examines the file specification or device name to see whether the 
leftmost component is a logical name. If the leftmost component ends with a 
colon, space, comma, or a line terminator (for example, RETURN), the system 
attempts to translate it as a logical name. If the leftmost component ends with 
any other character, the system does not attempt to translate it as a logical 
name. 

After you enter the command shown in the following example, the system 
checks to see whether PUP is a logical name because PUP is the leftmost 
component of the file specification. Because the leftmost component is 
terminated with RETURN, the system attempts to translate PUP. 

$ TYPE PUP 

After you enter the command shown in the next example, the system checks 
whether DISK is a logical name. The system attempts to translate DISK 
because it is the leftmost component and ends with a colon. (The system 
does not check PUP.) 
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$ TYPE DISK:PUP 

In the third example, the system does not try to translate [DRYSDALEJPUP 
because the leftmost component ends with a square bracket (]): 

$ TYPE [DRYSDALEJPUP 

By default, when the system translates logical names in file specifications, it 
searches the process, job, group, and system tables in that order, and uses the 
first match it finds. 


4.4.1 Iterative T ranslation 

Logical name translation can be iterative. This means that after the system 
translates a logical name, it repeats the translation process for any logical 
names it finds contained within the first logical name. For example: 

$ DEFINE DISK DUA1: 

$ DEFINE MEMO DISK:[JEFF.MEMOS]COMPLAINT.TXT 

In this example, the first DEFINE command equates the logical name DISK to 
the device name DUA1. The second DEFINE command equates the logical 
name MEMO to the file specification DISK:[JEFF.MEMOS]COMPLAINT.TXT. 
When the system translates the logical name MEMO, it finds the equivalence 
name DISK:[JEFF.MEMOS]COMPLAINT.TXT. It then checks to see whether 
the leftmost component in this file specification ends in a colon, a space, a 
comma, or an end-of-line terminator. It finds a colon after DISK. The system 
translates that logical name also. The final translation of the file specification 
is as follows: 

DUAl:[JEFF.MEMOS]COMPLAINT.TXT 

The system limits the number of levels to which it performs logical name 
translation. The number of levels varies among system facilities, but it is at 
least nine. If you define more than the system-determined number of levels, 
or if you create a circular definition, an error occurs when the logical name is 
used. 


4.4.2 Modifying Logical Name Translation 

When you create a logical name, you can specify translation attributes 
that modify how the system interprets the equivalence name. Use the 
/TRANSLATION-ATTRIBUTES qualifier to the DEFINE command. (This 
is a positional qualifier: depending on where you place it on a command 
line, it can apply translation attributes to all equivalence names or only to 
certain ones.) Two translation attributes can be specified as values to the 
/TRANSLATION-ATTRIBUTES qualifier: CONCEALED and TERMINAL. 

The CONCEALED attribute causes the logical name of a device, rather than 
the physical name, to be displayed in system messages (except for the SHOW 
LOGICAL display). The CONCEALED attribute is usually specified when 
defining logical names for devices. Using concealed devices allows you to 
write programs and command procedures and perform other operations 
without being concerned about which physical device actually holds the disk 
or tape. It also lets you use names that are more meaningful than the physical 
device names. 
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The following example shows how to create a concealed device name: 

$ DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED DISK DJA3: 

$ SHOW DEFAULT 
DISK:[SAM.PUP] 

$ SHOW LOGICAL DISK 

"DISK" = "DJA3" (LNM$PROCESS_TABLE) 

The logical name DISK represents the physical device DJA3. Thus, the 
SHOW DEFAULT command displays the logical name DISK rather than the 
actual physical device name, DJA3. The SHOW LOGICAL command reveals 
the translation of DISK. 

The TERMINAL attribute prevents iterative translation of a logical name. 
That is, the equivalence name is not examined to see if it is also a logical 
name. The translation is "terminal" (final, or completed) after the first 
translation. 


4.4.3 System Defaults During Logical Name Translation 

When the system translates a logical name, it fills in any missing fields in a 
file specification. It fills them in with the current default device, directory, and 
version number. When you use a logical name to specify the input file for a 
command, the command uses the logical name to assign a file specification to 
the output file as well. 

If the equivalence name contains a file name and file type, the output file 
is given the same file name and file type. If the equivalence name does not 
contain a file type, a default file type is supplied. The file type supplied 
depends on the command you are using. 


4.5 Logical Name Access Modes 

The four access modes in the VMS operating system are as follows: 

• User-mode (the outermost and least privileged mode) 

• Supervisor-mode 

• Executive-mode 

• Kernel-mode (the innermost and most privileged mode) 

When you create a logical name with DCL commands, it has an access mode 
of user, supervisor, or executive. By default, logical names are created in 
supervisor mode; you must have SYSNAM privilege to create an executive 
mode logical name. To see the access mode for a logical name, use the 
SHOW LOGICAL/FULL command, as follows: 

$ SHOW LOGICAL/FULL PROJECT 

"PROJECT" [super] = "DISKI:[JONES]" (LNM$PROCESS_TABLE) 

This shows that the logical name PROJECT was created in supervisor mode. 

You can equate the same logical name to different equivalence strings in 
the same logical name table by specifying different access modes for each 
definition. The following example equates the logical name ACCOUNTS to 
two different equivalence names in the process logical name table—one in 
supervisor-mode and one in executive-mode: 
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$ DEFINE ACCOUNTS DISKI:[ACCOUNTS]CURRENT.DAT 

$ DEFINE/EXECUTIVE_MODE ACCOUNTS DISKI:[JANE.ACCOUNTS]OBSOLETE.DAT 

Logical names created in user mode are temporary. Define a logical name 
in user mode when you want to define it only for the execution of the 
next image. In the following example, the logical name ADDRESSES is 
automatically deleted after the execution of the program PAYABLE: 

$ DEFINE/USER.MODE ADDRESSES DISKI:[SAM.ACCOUNTS]OVERDUE.LIS 
$ RUN PAYABLE 

In looking up logical names, all privileged images and utilities, such as 
LOGINOUT and MAIL, bypass the user- and supervisor-mode portions of 
the system logical name table. Therefore, DIGITAL recommends that logical 
names for important system components (public disks and directories, for 
example) be defined in executive mode, using the DCL command 
DEFINE/SYSTEM/EXECUTIVE. (Only the operating system and privileged 
programs can create logical names in kernel-mode.) This operation requires 
either the SYSPRV or SYSNAM privilege. 


4.6 Creating a Logical Name Table 

The CREATE/NAME—TABLE command creates a logical name table and 
catalogs it in one of the directory logical name tables. (Logical names that 
identify logical name tables or that translate iteratively to logical name tables 
must always be entered into one of the directory logical name tables.) To 
create a logical name table that is private to your process, create the table 
in LNM$PROCESS_DIRECTORY (the default). If you want the table to be 
shareable, specify /PARENT_TABLE=LNM$SYSTEM_DIRECTORY with the 
CREATE/NAME—TABLE command. Creating shareable name tables requires 
SYSPRV privilege or ENABLE access to the parent table. 

The following example creates a process-private logical name table named 
TAX, places the definition for the logical name CREDIT in the table, and 
verifies the table's creation. (You must specify the /TABLE qualifier with the 
SHOW LOGICAL command to display a logical name in any table other than 
LNM$SYSTEM or LNM$PROCESS.) 

$ CREATE/NAME_TABLE TAX 

$ DEFINE/TABLE=TAX CREDIT [ACCOUNTS.CURRENT]CREDIT.DAT 
$ SHOW LOGICAL/TABLE=TAX CREDIT 

"CREDIT" = "[ACCOUNTS.CURRENT]CREDIT.DAT" (TAX) 

To make the system search a user-created logical name table automatically 
when processing file specifications, you must create a process-private version 
of the default search list (LNM$FILE—DEV) in 

LNM$PROCESS—DIRECTORY. To add the created table's name to the 
default search list, you can define LNM$FILE—DEV as follows: 

$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY LNM$FILE_DEV - 
_$ TAX,LNMSPROCESS.LNM$JOB,LNM$GR0UP.LNM$SYSTEM 

Placing the table's name first specifies that the system search that table first, 
and so on in the order of specification. 

To delete a logical name table, specify the table that contains it (the system 
or process directory logical name table) and the name of the table. Deleting a 
shareable logical name table requires DELETE access to the table or SYSPRV 
privilege. For example, to delete the logical name table TAX of the preceding 
example, specify the following command line: 
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$ DEASSIGN/TABLE=LMN$PROCESS_DIRECTORY TAX 

Note that all logical names in descendant tables (and the descendant tables 
themselves) are deleted when a parent logical name table is deleted. 


4.7 Search Lists 

A search list is a logical name that has more than one equivalence name. You 
can use a search list in any place you can use a logical name. For example: 

$ DEFINE GETTYSBURG [JONES.HISTORY],[JONES.WORKFILES] 

$ SHOW LOGICAL GETTYSBURG 

"GETTYSBURG" = "[JONES.HISTORY]" (LNM$PROCESS_TABLE) 

= "[JONES.WORKFILES]" 

The logical name GETTYSBURG is a search list because it has more than one 
equivalence name. 

When you use a logical name that is a search list, the system translates the 
logical name until it finds a match. The order in which you specify the 
equivalence strings determines the order in which the system translates the 
names. It uses each equivalence name listed in the definition until a match is 
found. 

A search list is not a wildcard. It is a list of places to look. Once a file is 
found, the search is ended. For example: 

$ TYPE GETTYSBURGiSPEECH.TXT 
DISKI:[JONES.HISTORY]SPEECH.TXT;2 

Fourscore and seven years ago, our fathers brought forth on 
this continent a new nation, conceived in liberty, and 
dedicated to the proposition that all men are created equal. 


In the previous example, the TYPE command searches the equivalence names 
[JONES.HISTORY] and [JONES.WORKFILES] in the order they were listed 
when GETTYSBURG was defined. Once it finds a file named SPEECH.TXT, 
the search is halted and the file is displayed. 

You can use a search list with a command that accepts wildcards. When you 
use wildcards, the system forms file specifications using each equivalence 
name in the search list. The command operates on each file specification that 
identifies an existing file. 

For example, if you specify the DIRECTORY command with a wildcard 
character in the version field, it finds all versions of SPEECH.TXT in the 
search list defined by GETTYSBURG, as shown in the following example: 

$ DIRECTORY GETTYSBURG:SPEECH.TXT;* 

Directory DISKI:[JONES.HISTORY] 

SPEECH.TXT;2 SPEECH.TXT;1 

Total of 2 files. 

Directory DISKI: [JONES.WORKFILES] 


4-15 







Using Logical Names 

4.7 Search Lists 


SPEECH.TXT;1 
Total of 1 file. 

Grand total of 2 directories, 3 files. 

The DIRECTORY command searches the equivalence names 
[JONES.HISTORY] and [JONES.WORKFILES] in the order they were listed 
when GETTYSBURG was defined. It finds a file named SPEECH.TXT in 
each directory. If SPEECH.TXT exists in only one of the directories, only 
one directory listing is displayed. If SPEECH.TXT does not exist in either 
directory, an error message is displayed indicating that the file was not found. 

When you use a search list with a command that does not accept wildcards in 
a file specification, the system forms a file specification using each equivalence 
name in the search list until a file specification for an existing file is found. 
The command affects only the first file found. For example: 

$ DEFINE DECEMBER DISKI:[FRED],W0RK2:[BARNEY] 

$ EDIT/EDT DECEMBER:QUOTAS.TXT 

First, the system forms the file specification DISKl:[FRED]QUOTAS.TXT and 
searches for that file. If QUOTAS.TXT is found in DISK1:[FRED], it is opened 
for editing. No other files are subsequently opened. If QUOTAS.TXT is not 
found in DISK1:[FRED], the system searches for it in WORK2:[BARNEY]. If 
QUOTAS.TXT is found there, it is opened. If it is not found, an error message 
is displayed. The system displays an error message only after it checks all 
equivalence names in a search list. Then the system reports an error only on 
the last file it attempted to find. 

The RUN command is an exception. When the RUN command is followed 
by a search list, the system forms file specifications as described previously. 
However, the system then checks to see whether any of the files in the list 
are installed images. It runs the first file in the search list that is an installed 
image. Then the RUN command terminates. 

If none of the file specifications are installed images, the system repeats 
the process of forming file specifications. This time it looks for each file 
specification on the disk. It runs the first file it finds there. An error message 
is displayed if none of the specified files is found ill either the known file list 
or on the disk. 


4.8 Logical Node Names 

A logical node name is a special type of logical name that can be used in 
place of a network node name or in place of a node name and an access 
control string. For example: 

$ DEFINE BOS "BOSTON""ADAMS JOHN""::" 

The logical name BOS is equated to the node name BOSTON and an access 
control string, where ADAMS is the user name and JOHN is the password. 
Use the logical name BOS to avoid typing (and displaying) your user name 
and password on the terminal screen. 

Note: Do not place a DEFINE command that includes a password in a file (your 
login command procedure, for example). If others read the file, they will 
see the password. 
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4.9 System-Created Logical Names 

The system creates a number of logical names for you when you start the 
system and log in. By default, DCL creates and assigns logical names to 
four process-permanent files. When you redefine these logical names, only 
your process is affected. The system defines other logical names that you can 
reassign only with special privileges. 



4.9.1 Process-Permanent Logical Names 

Process-permanent logical names are created by DCL when you log in and 
remain defined for the life of your process. You cannot deassign these 
logical names. You can redefine them (by specifying the same name in 
a DEFINE command), but if the redefined name is later deassigned, the 
process-permanent name is reestablished. These process-permanent logical 
names, as follows, are available to each user of the system at the process 
level: 

• SYS$INPUT—Logical name that refers to the default input device or file 

• SYS$OUTPUT—Logical name that refers to the default output device or 
file 

• SYS$ERROR—Logical name that refers to the default device or file to 
which the system writes messages 

• SYS$COMMAND—Logical name that refers to the value of SYS$INPUT 
when you log in 

Table 4-6 shows what these logical names are equated to by default. 


Table 4-6 Equivalence Names for Process-Permanent Logical 
Names 


Logical 

Name 

Interactive 

Mode 

Batch 

Mode 

Command 

Procedure 

SYS$COMMAND 

Terminal 1 

Disk 2 

Terminal 

SYS$INPUT 

Terminal 

Disk 

Disk 

SYS$ERROR 

Terminal 

Log file 3 

Terminal 

SYS$OUTPUT 

Terminal 

Log file 

Terminal 

device name of your terminal 

2 Device name of the initial default device 

3 Batch job log file 



The following sections describe how to use process-permanent logical names 
as file specifications. 
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4.9.1.1 Redefining SYS$INPUT 

You can redefine SYS$INPUT so that a command procedure reads input from 
the terminal or another file. For example, to edit a file from a command 
procedure, include the following lines in the command procedure: 

$ DEFINE/USER_MODE SYS$INPUT SYS$COMMAND 
$ EDIT/TPU MYFILE.DAT 


In the previous example, SYS$INPUT is redefined as SYS$COMMAND so 
that the editor obtains input from the terminal rather than from the command 
procedure file (the default). SYS$COMMAND refers to the terminal, the 
initial input stream when you logged in. The /USER_MODE qualifier tells 
the command procedure that SYS$INPUT is redefined only for the duration 
of the next image. In this example, the next image is the editor. When the 
editor is finished, SYS$INPUT resumes its default value; in this case, the 
default value is the command procedure file. 

Note that if you redefine SYS$INPUT, DCL ignores your definition. DCL 
always obtains input from the default input stream. However, images, such 
as command procedures, can use your definition for SYS$INPUT. 


4.9.1.2 Redefining SYSSOUTPUT 

You can redefine SYS$OUTPUT to redirect output from your default device 
to another file. When you redefine SYS$OUTPUT, the system opens a file 
with the name you specify in the logical name assignment. When you define 
SYS$OUTPUT, all subsequent output is directed to the new file. 

In the following example, SYS$OUTPUT is defined as MYFILE.LIS before 
the SHOW DEVICES command is entered. The display produced by SHOW 
DEVICES is directed to MYFILE.LIS in your current directory rather than to 
your terminal. You can manipulate this data as you would any other text file. 

$ DEFINE SYS$OUTPUT MYFILE.LIS 
$ SHOW DEVICES 

Remember to deassign SYS$OUTPUT, or output will continue to be written 
to the file you specify. Note that you can redefine SYS$OUTPUT in user 
mode (with DEFINE/USER_MODE) to redirect output from an image. This 
definition is in effect only until the next command image is executed. Once 
the command image is executed (that is, the output is captured in a file), the 
logical name SYS$OUTPUT resumes its default value. 

When you log in, the system creates two logical names called SYS$OUTPUT. 
One name is created in executive mode; the other name is created in 
supervisor mode. You can supersede the supervisor mode logical name 
by redefining SYS$OUTPUT. If you deassign the supervisor mode name, 
the system redefines SYS$OUTPUT in supervisor mode, using the executive 
mode equivalence name. You cannot deassign the executive mode name. 

In the following example, SYS$OUTPUT is redefined to the file TEMP.DAT. 
When SYS$OUTPUT is redefined, output from DCL and from images is 
directed to the file TEMP.DAT. The output from the SHOW LOGICAL 
command and from the SHOW TIME command is also sent to TEMP.DAT. 
When you deassign SYS$OUTPUT, the system closes the file TEMP.DAT 
and redefines SYS$OUTPUT to your terminal. When you enter the TYPE 
command, the output collected in TEMP.DAT is displayed on your terminal. 
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$ DEFINE SYS$OUTPUT TEMP.DAT 
$ SHOW LOGICAL SYSSOUTPUT 
$ SHOW TIME 
$ DEASSIGN SYS$OUTPUT 
$ TYPE TEMP.DAT 

"SYSSOUTPUT" = "DISKI:" (LNM$PROCESS_TABLE) 

31-DEC-JAN-1988 13:26:53 

When you redefine SYS$OUTPUT to a file, the logical name contains only 
the device portion of the file specification, even though the output is directed 
to the file you specify. In the previous example, when SYS$OUTPUT was 
redefined, the equivalence name contained the device name DISKI:, not the 
full file specification. 

If the system cannot open the file you specify when you redefine 
SYSSOUTPUT, an error message is displayed. 

After you redefine SYS$OUTPUT, most commands direct output to the 
existing version of the file. However, certain commands create a new version 
of the file before they write output. 

4.9.1.3 Redefining SYS$ERROR 

You can redefine SYS$ERROR to direct error messages to a specified file. 
However, if you redefine SYSSERROR so it is different from SYS$OUTPUT 
(or if you redefine SYS$OUTPUT without also redefining SYS$ERROR), DCL 
commands send informational, warning, error, and severe error messages to 
both SYSSERROR and SYSSOUTPUT. Therefore, you receive these messages 
twice—once in the file indicated by the definition of SYSSERROR and once in 
the file indicated by SYSSOUTPUT. Success messages are sent only to the file 
indicated by SYSSOUTPUT. 

If you redefine SYSSERROR and then run an image that references 
SYSSERROR, the image sends error messages only to the file indicated 
by SYSSERROR even if SYSSERROR is different from SYSSOUTPUT. Only 
DCL commands and images using standard VMS error display mechanisms 
send error messages to both SYSSERROR and SYSSOUTPUT when these files 
are different. 


4.9.1.4 Redefining SYSSCOMMAND 

Although you can redefine SYSSCOMMAND, DCL ignores your definition. 
DCL always uses the default definition for your initial input stream. 
However, if you execute an image that references SYSSCOMMAND, the 
image can use your new definition. 
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4.9.2 System-Permanent Logical Names 

The following table lists the logical names automatically defined when the 
system starts up. These names are available to all users of the system at the 
system level. 


Logical Name 

Equivalence Name 

DBGSlNPUT 

SYSSINPUT at the process level 

DBG$OUTPUT 

SYSSOUTPUT at the process level 

SYS$COMMON 

SYS$SYSDEVICE:[SYSn.SYSCOMMON.J, 
where n is the root directory number of your 


processor 

SYSSERRORLOG 

SYS$SYSROOT:[SYSERR] 

SYSSEXAMPLES 

SYSSSYSROOT :[SYSHLP.EXAMPLES] 

SYS$HELP 

SYSSSYSROOT :[SYSHLP] 

SYS$INSTRUCTION 

SYSSSYSROOT :[SYSCBI] 

SYS$LIBRARY 

SYSSSYSROOT :[SYSLIB] 

SYS$LOADABLE—IMAGES 

SYSSSYSROOT :[SYS$LDR] 

SYSSMAINTENANCE 

SYSSSYSROOT :[SYSMAINT] 

SYSSMANAGER 

SYSSSYSROOT :[SYSMGR] 

SYSSMESSAGE 

SYSSSYSROOT :[SYSMSG] 

SYSSNODE 

Name of your node if you are on a network 

SYSSSHARE 

SYSSSYSROOT :[SYSLIB] 

SYSSSPECIFIC 

SYS$SYSDEVICE:[SYSn.], where n is the root 
directory number of your processor 

SYSSSTARTUP 

As a search list, points first to 
SYSSSYSROOT:[SYS$STARTUP], then to 
SYSSMANAGER 

SYSSSYSDEVICE 

System disk (usually SYSSDISK) 

SYSSSYSROOT 

As a search list, points first to 
SYS$SYSDEVICE:[SYSn.], where n is the 
root directory number of your processor; then 
to SYSSCOMMON 

SYSSSYSTEM 

SYSSSYSROOT :[SYSEXE] 

SYSSTEST 

SYSSSYSROOT :[SYSTEST] 

SYSSUPDATE 

SYSSSYSROOT :[SYSUPD] 
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As you carry out your computing tasks with the support of DCL and VMS, 
you may need to store and manipulate data, such as numbers and strings of 
characters, through the use of symbols. Like files, symbols store data. Yet, 
unlike files, the symbols you create are temporary and have no means of 
physical storage—they exist only for the life of your computing session or for 
the life of a program's execution. 

This chapter describes the kinds of data you can use in DCL, how you can 
use symbols to represent that data, and how you can combine symbols into 
expressions to manipulate the data that the symbols represent. 


Data Storage 


With the VMS operating system, the most common units in which data can 

be stored are the following: 

• Bit—The most basic unit of storage, a bit has a value of 0 or 1. 

• Byte—Equal to 8 bits, a byte can represent an unsigned integer value of 
0 through 255 and a signed value of -128 through 127. Characters are 
stored one per byte. 

• Word—Equal to 2 bytes, a word can represent an unsigned integer value 
of 0 through 65,353 and a signed value of -32,768 through 32,767. 

• Longword—Equal to 4 bytes (32 bits), a longword can represent an 
unsigned integer value of 0 through 4,294,967,295 and a signed value of 
-2,147,483,648 through 2,147,483,647. 

The first unit in any series of these units is called the low-order unit. In 

numeric values, the low-order unit is the least-significant unit in the number. 

For example, in a binary number composed of the series of bits 11111110, the 

0 is the low-order bit. 


Creating and Using Symbols 

A symbol is a name that represents a character value (for example, "DOG"), 
a numeric value (for example, 17), or a logical value (for example. True). 
When you use a symbol in a DCL command, DCL replaces the symbol with 
its value before executing the command. Symbols are useful for- representing 
data in commands and command procedures and as shortcuts for entering 
commands you use frequently. 

For example, you may define a symbol as any of the following: 

• Foreign command—Defining a symbol as a foreign command allows you 
to execute an image by entering only the symbol name. (The command 
is "foreign" because it is unknown to DCL.) In the following example, the 
symbol FIX is defined to execute the image NUMFIX.EXE in the [BILLS] 
directory on the disk ACCOUNTS: 

$ FIX == "$ACC0UNTS:[BILLS]NUMFIX" 
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• Command line—Defining a symbol as a command line allows you 
to execute the command by entering only the symbol name. In the 
following example, the symbol HUBBUB is defined to establish a network 
connection to the node HUBBUB: 

$ HUBBUB == "SET HOST HUBBUB" 

Setting a symbol equal to a command line that executes a command 
procedure allows you to execute the procedure by typing only the symbol 
name. In the following example, COUNT is defined to execute the 
command procedure CENSUS: 

$ COUNT == "QDISK1: [JONES.PROCEDURES]CENSUS" 

When you enter COUNT to execute CENSUS, place any parameters for 
CENSUS after the symbol as if you had entered @CENSUS. 

• Character string—Defining a symbol as a character string allows you 
to insert that string in a command line by typing the symbol (with 
surrounding apostrophes to force substitution, as described in Section 5.5). 
In the following example, the symbol FILE is first defined as a complete 
file specification and then used in the TYPE command: 

$ FILE == "DISKI:[JONES.TAXES]CORPORATE.DAT" 

$ TYPE 'FILE' 

The string can be a directory you often access. In the following example, 
whenever the symbol TAXES occurs in a command line, the literal value 
replaces the symbol before the line is executed. 

$ TAXES == "[JONES.TAXES]" 

$ COPY 'TAXES’OVERDUE.DAT OVERDUE.TMP 

Symbols can also hold variables, which are values that you calculate or that 
you assign as something other than a literal. For example, you might assign 
the value of a lexical function to a variable or read the value of a file record 
into a variable. As variables, symbols are most often used in command 
procedures (see Chapter 6). 

To create a symbol, assign a value to a symbolic name using the following 
format: 

symbol-name =[=] value 

The symbol name can be 1 through 255 characters long and must begin with 
a letter, an underscore (_), or a dollar sign ($). In a symbol name, both 
lowercase and uppercase letters are treated as uppercase. 

The value you assign to a symbol can be made either locally or globally 
available to the command interpreter: 

• Local—A local symbol is available to the command level that defined 
it, to any command procedure executed from that level, and to lower 
command levels. (By convention, DCL level—command level 0—is the 
highest command level and command level 31 the lowest command level. 
Thus, when you move from command level 3 to command level 2, you 
are moving to the next higher command level. If you execute a command 
procedure interactively, the commands in the procedure are executed at 
command level 1. You can create a maximum of 32 command levels.) 
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• Global—A global symbol is available to any command level regardless of 
the level at which it was defined. 

To create a local symbol, use a single equal sign in the assignment 
statement. To create a global symbol, use two equal signs. The 
following commands define the local symbol FILE as the character string 
DISK2:[BOLIVAR]PRICES.CUR and the global symbol MAX-VALUE as the 
number 24. 

$ FILE = "DISK2:[BOLIVAR]PRICES.CUR" 

$ MAX.VALUE == 24 

You can omit the quotation marks around character strings in assignment 
statements if you precede the equal sign or signs with a colon. Symbol 
assignments that omit quotation marks automatically change the character 
string to uppercase letters and compress multiple spaces and tabs to a single 
space. The following example again creates the local symbol FILE, this time 
omitting the quotation marks because of the included colon: 

$ FILE := ACCOUNTS:[BOLIVAR]PRICES.84 

The result of DCL's evaluation of a symbol is either a character string or an 
integer value. The data type (character or integer) of a symbol is determined 
by the data type of the value currently assigned. The type is not permanent: 
if the value changes type, as in the following example, the symbol changes 
type. In the following example, the local symbol NUM is first assigned a 
character value and then converted to an integer value when used in an 
expression with an integer: 

$ NUM = "12" 

$ RESULT = NUM + 10 

Local symbols take precedence over global symbols with the same name. 
Symbols take precedence over identical command names. This means that if 
you define a symbol with the same name as a DCL command, your definition 
overrides the command name. For example, if you define the symbol HELP 
as the command TYPE HELP.LST, you can no longer invoke the system's 
HELP facility by typing HELP. 

Symbols are stored in the following tables, which are maintained by the 
operating system: 

• Local symbol table—DCL maintains a local symbol table for your main 
process and for every command level that you create when you execute a 
command procedure, use the CALL command, or submit a batch job. A 
local table is deleted when its associated command level terminates. (See 
Chapter 3 for more information about processes, command procedures, 
and batch jobs.) 

In addition to the local symbols you create, a local symbol table contains 
eight symbols that are maintained by DCL. These symbols, named PI, 

P2, and so on through P8, are used for passing parameters to a command 
procedure. Parameters passed to a command procedure are regarded as 
character strings. Otherwise, PI through P8 are defined as null character 
strings (**). They are stored in the local symbol table. 

• Global symbol table—DCL maintains only one global symbol table for 
the duration of a process. In addition to the global symbols you create, 
the global symbol table contains the reserved global symbols described in 
the following table. These global symbols give you status information on 
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your programs and command procedures as well as on system commands 
and utilties. 


Reserved 

Global 

Symbols Definition 


$STATUS 


SSEVERITY 


$RESTART 


The condition code returned by the most recently executed 
command. SSTATUS conforms to the format of a VMS 
message code. User programs can set the value of the global 
symbol SSTATUS by including a parameter value to the 
EXIT command. The system uses the value of SSTATUS to 
determine which message, if any, to display and whether to 
continue execution at the next-higher command level. The 
value of the lower three bits in SSTATUS is placed in the 
global symbol SSEVERITY. 

The severity level of the condition code returned by the most 
recently executed command. SSEVERITY, which is equal to 
the lower three bits of SSTATUS, can have the following 
values: 

0 Warning 

1 Success 

2 Error 

3 Information 

4 Severe (fatal) error 

Has the value TRUE if a batch job was restarted after it was 
interrupted by a system crash. Otherwise, SRESTART has the 
value FALSE. 


5.3 Abbreviating Symbol Names 

You can use abbreviated forms of symbols if you define them with the 
asterisk. The following example shows how to create a local symbol that can 
be abbreviated: 

$ M*AIL = "MAIL" 

Once this symbol is established, the VMS Mail Utility is invoked whenever 
you specify any of the following versions of the symbolic name: 

$ M 
$ MA 
$ MAI 
$ MAIL 

Generally, you can use abbreviated symbol definitions in any situation that 
allows a symbol to be used. However, there are some restrictions as follows: 

• You cannot abbreviate symbols that involve substring replacement. 

• When you define a symbol that includes an asterisk, existing symbols 
may possibly be deleted. If an existing symbol exactly matches the new 
symbol at or past the asterisk, the new symbol replaces the existing 
symbol. 
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5.4 


• If you define a symbol with an asterisk, you cannot define another symbol 
whose name partly matches the existing symbol at or past the asterisk. 


DCL Commands to Use with Symbols 

Table 5-1 shows the DCL commands you can use with symbols. 


Table 5—1 DCL Commands to Use with Symbols 


Command 

Function 

SHOW SYMBOL 

Displays the value of the specified symbol. By 
default, the SHOW SYMBOL command searches the 
local symbol tables and then the global symbol table 
to locate a specified symbol name. 

DELETE/SYMBOL 

Deletes a symbol. By default, the DELETE/SYMBOL 
command searches for symbols only in the local 
symbol table. To delete a global symbol, use the 
/GLOBAL qualifier. 

SET SYMBOL/SCOPE 

You can mask global or local symbols at the specified 
command level. 

INQUIRE 

Reads a value from SYS$COMMAND and assigns it 
to a symbol. 

READ 

Reads a record from a file and assigns its contents to 
a symbol. 


The SHOW SYMBOL command displays symbol values. Specify the name 
of the symbol to display the value of a particular local symbol. Specify the 
name of the symbol and /GLOBAL to display the value of a particular global 
symbol. Specify /ALL to display all local symbols and /ALL/GLOBAL to 
display all global symbols. 

The DELETE/SYMBOL command deletes a symbol. You must include the 
/GLOBAL qualifier to delete a global symbol. In the following example, the 
global symbol TEMP is deleted: 

$ DELETE/SYMBOL/GLOBAL TEMP 

The SET SYMBOL/SCOPE=(keyword,...) command controls access to local 
and global symbols in command procedures. This allows you to treat symbols 
as undefined without deleting them. Symbol scoping works differently for 
local and global symbols. 

If you specify /SCOPE=NOLOCAL, all local symbols defined in an outer 
procedure level are treated as undefined by the current procedure and any 
inner levels. Specifying LOCAL removes any symbol translation limit set by 
the current procedure level. 

For example, if SET SYMBOL/SCOPE=NOLOCAL was specified at procedure 
levels 2 and 4, procedure level 2 can access only procedure level 2 local 
symbols. Procedure level 3 can access procedure levels 2 and 3 local symbols; 
procedure level 4 can access procedure level 4 local symbols and any local 
symbols in inner procedure levels. 
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Global symbols are not procedure level dependent. The global symbol 
scoping state (GLOBAL or NOGLOBAL) that is in effect when a new 
procedure level is invoked is propagated to the new procedure level. 
Specifying /SCOPE=NOGLOBAL makes all global symbols inaccessible 
for all subsequent commands until you either specify /SCOPE=GLOBAL or 
exit to a previous level at which global symbols were accessible. 

In the following example, the SET SYMBOL command denies access to all 
global symbols: 

$ SET SYMB0L/SC0PE=N0GL0BAL 

Exiting a procedure level back to an outer procedure level causes the symbol 
scope-state to be restored for both local and global symbols. 

The INQUIRE and READ commands are most often used within DCL 
command procedures and are therefore discussed in Chapter 6. 


5.5 Symbol Substitution 

When a command line is executed, symbols in the following positions are 
automatically substituted: 

• On the right side of an [:]= or [:]== assignment statement 

• In a lexical function 

• In the brackets on the left side of an assignment statement when you are 
performing substring substitution or number overlays (see Section 5.6.2.4) 

• In a DEPOSIT, EXAMINE, IF, or WRITE command 

• At the beginning of the command line 

To force substitution of a symbol that is not in one of the positions listed, 
enclose the symbol with apostrophes as follows: 

$ TYPE 'B' 

To force substitution of a symbol within a quoted character string, precede 
that symbol with double apostrophes and follow it with a single apostrophe 
as follows: 

$ T = "TYPE ' ■ B 

When processing a command line, DCL replaces symbols with their values in 
the following order: 

• Forced substitution—From left to right, DCL replaces all strings 
delimited by apostrophes (or double apostrophes for strings within 
quotation marks). Symbols preceded by single apostrophes are translated 
iteratively; symbols preceded by double apostrophes are not. 

• Automatic substitution—From left to right, DCL evaluates each value in 
the command line, executing it if it is a command and evaluating it if it 
is an expression. Symbols in expressions are replaced by their assigned 
values; this substitution is not iterative. 
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The following example demonstrates the effect of the order in which DCL 
substitutes symbols. Assume the following symbol definitions: 

$ PN = "PRINT/NOTIFY" 

$ FILE1 = "[BOLIVARlTEST_CASE.TXT" 

$ NUM = 1 

Given the preceding symbol definitions, the following commands print the 
file named [BOLIVAR]TEST_CASE.TXT: 

$ FILE = "'FILE''NUM''" 

$ PN 'FILE' 

In the first command, forced substitution causes NUM to become 1, making 
FILE"NUM' become FILE1. If you enter the command SHOW SYMBOL FILE, 
you will see that FILE = "'FILE1'". 

The second command performs two substitutions. First, 'FILE' is substituted 
with 'FILE1'. 'FILE1' also requires substitution because it is enclosed in 
single quotation marks. Automatic substitution causes FILE1 to become 
[BOLIVARJTEST_CASE.TXT. This file name is then appended to the value of 
PN, which is PRINT/NOTIFY. The resulting string is as follows: 

$ PRINT/NOTIFY [BOLIVARlTEST_CASE.TXT 


5.6 Storing and Manipulating Data with Symbols 

You can use symbols to store and manipulate a variety of values. This 
section describes the values that can be stored in symbols. It also describes 
how symbols can be combined in expressions to manipulate the values the 
symbols contain. 


5.6.1 Symbol Values 

A symbol can be defined as a character string, a number, a lexical function, 
a logical value, or another symbol. The following sections describe these 
values. 


5.6.1.1 Character String Values 

A character string can contain any characters that can be printed. 

Appendix A, which includes tables of the ASCII character set and the DEC 

Multinational Character Set, shows those characters that you can include in a 

character string. 

Characters fall into the following three main categories: 

• Alphanumeric characters—The uppercase letters A through Z, the 
lowercase letters a through z, the digits 1 through 9, the dollar sign 
($), the underscore (_), and the hyphen (-). 

• Special characters—All other characters that can be displayed or printed: 
the exclamation point (!), quotation marks ("), number sign (#), and so 
on. 

• Nonprintable characters—All characters that cannot be printed or 
displayed. In general, nonprintable characters are ignored for display 
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and print purposes. However, several nonprintable characters serve 
control functions as follows: 


Character Function 


HT Starts printing or typing at the next horizontal tab 

LF Starts printing or typing on the next line 

FF Starts printing or typing at the top of the next page 

CR Starts printing or typing at the first space on the same line 

ESC Introduces a terminal escape sequence 

SP Inserts one space 


You can define a character string by enclosing it in quotation marks. In this 
way, alphabetic case and spaces are preserved when the symbol assignment 
is made. 


5.6.1.2 Numeric Values 

A number can have the following values: 

• Decimal—The ASCII characters 0 through 9 

• Hexadecimal—The ASCII characters 0 through 9 and A through F 

• Octal—The ASCII characters 0 through 7 

The number you assign to a symbol must be in the range -2147483648 
through 2147483647 (decimal). (An error is not reported if a number outside 
this range is specified or calculated, but an incorrect value results.) 

At DCL command level and within command procedures, specify a number 
as follows: 

• Positive numbers—Specify a positive number by typing the appropriate 
digits. The following example assigns the number 13 to the symbol 
DOG—COUNT: 

$ DOG.COUNT = 13 
$ SHOW SYMBOL DOG.COUNT 

DOG.COUNT = 13 Hex = 0000000D Octal = 00000000015 

• Negative numbers—Precede a negative number with a minus sign, as in 
the following example: 

$ BALANCE = -15237 
$ SHOW SYMBOL BALANCE 

BALANCE = -15237 Hex = FFFFC47B Octal = 37777742173 

• Radix—Specify a number in a radix other than decimal by preceding the 
number (but not the minus sign) with %X for hexadecimal numbers and 
%0 for octal numbers. For example: 

$ DOG.COUNT = # /,XD 
$ SHOW SYMBOL DOG.COUNT 

DOG.COUNT = 13 Hex = 0000000D Octal = 00000000015 

$ BALANCE = - # / # X3B85 
$ SHOW SYMBOL BALANCE 

BALANCE = -15237 Hex = FFFFC47B Octal = 37777742173 
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• Fractions—A number cannot include a decimal point. In calculations, 

fractions are truncated; for example, 8 divided by 3 equals 2. 

Numbers are stored internally as signed 4-byte integers, called longwords; 
positive numbers have values of 0 through 2147483647 and negative numbers 
have values of 4294967296 minus the absolute value of the number. The 
number -15237, for example, is stored as 4294952059. Negative numbers are 
converted back to minus-sign format for ASCII or decimal displays; however, 
they are not converted back for hexadecimal and octal displays. For example, 
the number -15237 appears in displays as hexadecimal FFFFC47B (decimal 
4294952059) rather than hexadecimal -00003B85. 

Numbers are stored in text files as a series of digits using ASCII conventions 
(for example, the digit 1 has a storage value of 49). 


5.6.1.3 Values Returned by Lexical Functions 

Typically used in command procedures, lexical functions provide users with 
a means to obtain information from the system, including information about 
system processes, batch and print queues, and user processes. You can 
also use lexical functions to manipulate character strings and translate logical 
names. When you assign a lexical function to a symbol, the symbol is equated 
to the information returned by the lexical function (for example, a number 
or character string). At DCL level, you can then display that information 
with the DCL command SHOW SYMBOL. In a command procedure, the 
information stored in the symbol can be used later in the procedure. See the 
VMS DCL Dictionary for a description of each lexical function. 

To use a lexical function, type the name of the lexical function (which always 
begins with F$) and its argument list. Use the following syntax: 

F$function-name(args[,...]) 

The argument list follows the function name with any number of intervening 
spaces and tabs. When using a lexical function, observe the following rules: 

• Enclose the argument list in parentheses. 

• Within the list, specify arguments in exact order and separate them with 
commas; even if you omit an optional argument, do not omit the comma. 

• If no arguments are required, type an empty set of parentheses. 

• Do not enclose lexical functions in quotation marks. 

• If an argument contains a character string, enclose the character string in 
quotation marks. 

• If an argument contains an integer, a symbol, or another lexical function, 
do not enclose these values in quotation marks. 

Use lexical functions the same way you would use character strings, integers, 
and symbols. The following example uses the F$LENGTH function. 

F$LENGTH returns an integer that specifies the length of the string. The 
returned value is assigned to the symbol LEN. 

$ LEN = F$LENGTH("The cow jumped over the moon.") 

$ SHOW SYMBOL LEN 

LEN = 29 Hex = 0000001D Octal = 00000000035 
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You can use a lexical function in any position that you can use a symbol. In 
positions where symbol substitution must be forced by enclosing the symbol 
in apostrophes, lexical function evaluation must be forced by placing the 
lexical function within apostrophes. Lexical functions can also be used as 
argument values in other lexical functions. 

The following example equates the length of the character symbol LINE to a 
numeric symbol named L: 

$ L = F$LENGTH (LINE) 

The following example strips the last two characters from the character string 
that is the value of the symbol LINE: 

$ LINE = F$EXTRACT (0,F$LENGTH(LINE) - 2 , LINE) 


5.6.1.4 Logical Values 

Some operations interpret numbers and character strings as logical data with 

values as follows: 

• True—A number has a logical value of true if it is odd (that is, the low- 
order bit is 1). A character string has a logical value of true if the first 
character is an uppercase or lowercase T or Y. 

• False—A number has a logical value of false if it is even (that is, the 
low-order bit is 0). A character string has a logical value of false if the 
first character is not an uppercase or lowercase T or Y. 

In both of the following examples, DOG_COUNT is assigned the value 13. 

IF STATUS means if the logical value of STATUS is true. 

$ STATUS = 1 

$ IF STATUS THEN DOG.COUNT = 13 

$ STATUS = "TRUE" 

$ IF STATUS THEN DOG.COUNT = 13 


5.6.1.5 Using a Symbol as a Value for Another Symbol 

After a symbol is defined, it can be used as a value for another symbol. It can 
be interpreted as a character string or a number, depending on the context in 
which it is used. For example, suppose a symbol, COUNT, is assigned the 
integer value 3 as follows: 

$ COUNT = 3 

Then the value of COUNT can be used in other assignment statements. In 
the following example, the value of COUNT is added to 1: 

$ TOTAL = COUNT + 1 

The result, 4, is equated to the symbol TOTAL. You can confirm the 
assignment of the value to TOTAL by entering the SHOW SYMBOL 
command as follows: 

$ SHOW SYMBOL TOTAL 

TOTAL = 4 Hex = 00000004 Octal = 00000000004 
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You can include the symbol COUNT in a string assignment statement as 
follows: 

$ BARK := P'COUNT 1 

COUNT is converted to a string value and appended to the character P. BARK 
now has the value P3. 

To include a symbol in a string assignment, use either a colon and an equal 
sign (:=) or a colon and two equal signs (:==), and enclose the symbol in 
apostrophes. Otherwise, DCL will not recognize it as a symbol. 

If you define a null character string for a symbol, that symbol has a value of 
0, as shown in the following example: 

$ A = "" 

$ B = 2 
$ C = A + B 
$ SHOW SYMBOL C 

C = 2 Hex = 00000002 Octal = 00000000002 


5.6.2 Using Symbols in Expressions 

An expression is a combination of values. Each value in an expression is 
connected to another value by an operator. Operators are denoted in the 
following ways: 

• Special characters—Asterisk (*), slash (/), plus sign ( + ), and minus 
sign (-). 

• Special names—.EQ., .GE., .GT., .LE., .LT., .NE., .NOT., .AND., and 
.OR.; the names can be uppercase or lowercase. 

Data entities and operators can be adjacent or can be separated by any 
number of spaces or tabs. The values in the expression can be symbols or 
literal values (si*ch as 3 or "DOG"). Expressions take the following two forms: 

• Operations—An operation combines two data entities or alters a data 
entity. The following example combines the literal values 10 and 3 by 
adding them: 

$ D0G_C0UNT =10+3 
$ SHOW SYMBOL D0G_C0UNT 

D0G_C0UNT = 13 Hex = 0000000D Octal = 00000000015 

• Comparisons—A comparison evaluates a relationship between two 
entities as true or false. A true comparison evaluates to a numeric value 
of 1, and a false comparison evaluates to a numeric value of 0. The 
following example compares the value of the symbol DOG—COUNT with 
the literal value 13 and finds them to be equal: 

$ D0G_CHECK = D0G.C0UNT .EQ. 13 
$ SHOW SYMBOL D0G_CHECK 

D0G_CHECK =1 Hex = 00000001 Octal = 00000000001 

You can create character string expressions, numeric expressions, and logical 
expressions. These are described in the following sections. 
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5.6.2.1 Character String Expressions 

A character string expression can contain character strings, lexical functions 
that evaluate to character strings, or symbols that have character string 
values. Attempting an operation or comparison between a character string 
and a number causes the character string to be converted to a number. 

You can specify the following character string operations: 

• Concatenation—The plus sign concatenates two character strings. For 
example: 

$ COLOR = "light brown" 

$ WEIGHT = "30 lbs." 

$ D0G2 = "No tag, " + COLOR + ", " + WEIGHT 
$ SHOW SYMBOL D0G2 

D0G2 = "No tag, light brown, 30 lbs." 

• Reduction—The minus sign removes the second character string from the 
first character string. For example: 

$ SHOW SYMBOL D0G2 

D0G2 = "No tag, light brown, 30 lbs." 

$ D0G2 = D0G2 - ", 30 lbs." 

$ SHOW SYMBOL D0G2 

D0G2 = "No tag, light brown" 

If the second character string occurs more than once in the first character 
string, only the first occurrence of the string is removed. 

When you compare two character strings, the strings are compared character 
by character; strings of different lengths are not equal (for example, "dogs" is 
greater than "dog"). 

The comparison criteria are the ASCII values of the characters. Under this 
criterion, the digits 0 through 9 are less than the letters A through Z, and the 
uppercase letters A through Z are less than the lowercase letters a through 
z. A character string comparison terminates when either of the following 
conditions is true: 

1 All the characters have been compared, in which case the strings are 
equal. 

2 The first mismatch occurs. 

You can specify the following varieties of string comparisons. In the 
examples, assume that the symbol LAST-NAME has the value "WHITFIELD." 


• Equal to—The operator .EQS. compares one character string to another 
for equality. The following comparison evaluates to 0 to indicate that the 
value of the symbol LAST—NAME does not equal the literal "NORMAN": 

$ TEST.NAME = LAST.NAME .EQS. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST.NAME =0 Hex = 00000000 Octal = 00000000000 

• Greater than or equal to—The operator .GES. compares one character 
string to another for a greater or equal value in the first specified string. 
The following comparison evaluates to 1 to indicate that the value of the 
symbol LAST-NAME is greater than or equal to the literal "NORMAN": 
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$ TEST.NAME = LAST.NAME .GES. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST_NAME =1 Hex = 00000001 Octal = 00000000001 

• Greater than—The operator .GTS. compares one character string to 
another for a greater value in the first specified string. The following 
comparison evaluates to 1 to indicate that the value of the symbol 
LAST_NAME is greater than the literal "NORMAN": 

$ TEST.NAME = LAST.NAME .GTS. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST.NAME =1 Hex = 00000001 Octal = 00000000001 

• Less than or equal to—The operator .LES. compares one character string 
to another for a lesser or equal value in the first specified string. The 
following comparison evaluates to 0 to indicate that the value of the 
symbol LAST__NAME is not less than or equal to the literal "NORMAN": 

$ TEST.NAME = LAST.NAME .LES. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST.NAME =0 Hex = 00000000 Octal = 00000000000 

• Less than—The operator .LTS. compares one character string to another 
for a lesser value in the first specified string. The following comparison 
evaluates to 0 to indicate that the value of the symbol LAST__NAME is 
not less than the literal "NORMAN": 

$ TEST.NAME = LAST.NAME .LTS. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST.NAME =0 Hex = 00000000 Octal = 00000000000 

• Not equal—The operator .NES. compares one character string to another 
for inequality. The following comparison evaluates to 1 to indicate 
that the value of the symbol LAST__NAME does not equal the literal 
"NORMAN": 

$ TEST.NAME = LAST.NAME .NES. "NORMAN" 

$ SHOW SYMBOL TEST.NAME 

TEST.NAME =1 Hex = 00000001 Octal = 00000000001 


5.6.2.2 Numeric Expressions 

In a numeric expression, the values involved must be literal numbers (such 
as 3) or symbols with numberic values. In addition, you can use a character 
string that represents a number (for example, "23" or "-51"). Attempting an 
operation or comparison between a number and a character string causes the 
character string to be converted to a number. 

You can specify the following numeric operations: 

• Multiplication—The asterisk multiplies two numbers. For example: 

$ BALANCE = 142 * 14 
$ SHOW SYMBOL BALANCE 

BALANCE = 1988 Hex = 000007C4 Octal = 00000003704 

• Division—The slash divides the first specified number by the second 
specified number. For example: 

$ BALANCE = BALANCE / 14 
$ SHOW SYMBOL BALANCE 

BALANCE = 142 Hex = 0000008E Octal = 00000000216 

If a number does not divide evenly, the remainder is lost. (No rounding 
takes place.) 
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• Addition—The plus sign adds two numbers. For example: 

$ BALANCE = BALANCE + 37 
$ SHOW SYMBOL BALANCE 

BALANCE = 179 Hex = 000000B3 Octal = 00000000263 

• Subtraction—The minus sign subtracts the second specified number from 
the first specified number. For example: 

$ BALANCE = BALANCE - 15416 
$ SHOW SYMBOL BALANCE 

BALANCE = -15237 Hex = FFFFC47B Octal = 00000142173 

• Unary plus and minus—The plus and minus signs change the sign of the 
number they precede. For example: 

$ BALANCE = -(-142) 

$ SHOW SYMBOL BALANCE 

BALANCE = 142 Hex = 0000008E Octal = 00000000216 

You can specify the following numeric comparisons: 

• Equal to—The operator .EQ. compares one number to another for 
equality. The following comparison evaluates to 1 to indicate that 
BALANCE equals -15237: 

$ TEST.BALANCE = BALANCE .EQ. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =1 Hex = 00000001 Octal = 00000000001 

• Greater than or equal to—The operator .GE. compares one number to 
another for a greater or equal value in the first number. The following 
comparison evaluates to 1 to indicate that BALANCE is greater than or 
equal to -15237: 

$ TEST_BALANCE = BALANCE .GE. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =1 Hex = 00000001 Octal = 00000000001 

• Greater than—The operator .GT. compares one number to another for a 
greater value in the first number. The following comparison evaluates to 
0 to indicate that BALANCE is not greater than -15237: 

$ TEST.BALANCE = BALANCE .GT. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =0 Hex = 00000000 Octal = 00000000000 

• Less than or equal to—The operator .LE. compares one number to 
another for a lesser or equal value in the first number. The following 
comparison evaluates to 1 to indicate that BALANCE is less than or equal 
to -15237: 

$ TEST.BALANCE = BALANCE .LE. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =1 Hex = 00000001 Octal = 00000000001 

• Less than—The operator .LT. compares one number to another for a 
lesser value in the first number. The following comparison evaluates to 0 
to indicate that BALANCE is not less than -15237: 

$ TEST.BALANCE = BALANCE .LT. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =0 Hex = 00000000 Octal = 00000000000 
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• Not equal to—The operator .NE. compares one number to another for 

inequality. The following comparison evaluates to 0 to indicate that 
BALANCE equals -15237: 

$ TEST.BALANCE = BALANCE .NE. -15237 
$ SHOW SYMBOL TEST.BALANCE 

TEST.BALANCE =0 Hex = 00000000 Octal = 00000000000 


5.6.2.3 Logical Expressions 

A logical operation affects all the bits in the number being acted upon. The 
values for logical expressions are integers, and the result of the expression 
is an integer as well. If you specify a character string value in a logical 
expression, the string is converted to an integer before the expression is 
evaluated. 

String and integer values are evaluated as follows: 

• If the first character is T, t, Y, or y, a character string has a logical value 
of true (1). 

• If the first character is not T, t, Y, or y, a character string has a logical 
value of false (0). 

• If an integer is odd (the low-order bit is 1), it has a logical value of true 

( 1 ). 

• If an integer is even (the low-order bit is 0), it has a logical value of false 

( 0 ). 

Typically, you use logical expressions to evaluate the low-order bit of a logical 
value; that is, to determine whether the value is true or false. You can specify 
the following logical operations: 

• Not—The operator .NOT. reverses the bit configuration of a logical value. 
A true value becomes false and a false value becomes true. The following 
example reverses a true value to false. The expression evaluates to -2; 
the value is even and is therefore false: 

$ SHOW SYMBOL STATUS 

STATUS =1 Hex = 00000001 Octal = 00000000001 
$ STATUS = .NOT. STATUS 
$ SHOW SYMBOL STATUS 

STATUS = -2 Hex = FFFFFFFE Octal = 37777777776 

• And—The operator .AND. combines two logical values as follows: 


Bit Level 

Entity Level 

1 .AND. 1 = 1 

true .AND. true = true 

1 .AND. 0 = 0 

true .AND. false = false 

0 .AND. 1 =0 

false .AND. true = false 

0 .AND. 0 = 0 

false .AND. false = false 
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The following example combines a true value and a false value to produce 
a false value: 

$ STAT1 = "TRUE" 

$ STAT2 = "FALSE" 

$ STATUS = STAT1 .AND. STAT2 
$ SHOW SYMBOL STATUS 

STATUS =0 Hex = 00000000 Octal = 00000000000 
• Or—The operator .OR. combines two logical values as follows: 


Bit Level 

Entity Level 

1 .OR. 1 = 1 

true .OR. true = true 

1 .OR. 0 = 1 

true .OR. false = true 

0 .OR. 1 = 1 

false .OR. true = true 

0 .OR. 0 = 0 

false .OR. false = false 


The following example combines a true value and a false value to produce 
a true value: 

$ STATl = "TRUE" 

$ STAT2 = "FALSE" 

$ STATUS = STATl .OR. STAT2 
$ SHOW SYMBOL STATUS 

STATUS =1 Hex = 00000001 Octal = 00000000001 


5.6.2.4 Subst/ing Replacement and Numeric Overlays 

You can replace a part of a character string with another character string. The 
assignment statement has the following format: 

symbol-name[offset,size] := replacement-string 

or 

symbol-name[offset,size] := = replacement-string 
The fields are as follows: 

• Offset is an integer that indicates the position of the replacement¬ 
string relative to the first character in the original string. An offset of 

0 means the first character in the symbol, an offset of 1 means the second 
character, and so on. 

• Size is an integer that indicates the length of the replacement-string. 

To replace substrings, observe the following rules: 

• The square brackets are required notation. No spaces are allowed 
between the symbol name and the left bracket. 

• Integer values can be in the range of 0 through 768. 

• The replacement-string must be a character string. 

In the following example, the first assignment statement gives the symbol 
A the value PACKRAT. The second statement specifies that MUSK replace 
the first four characters in the value of A. The result is that the value of A 
becomes MUSKRAT. 
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$ A := PACKRAT 
$ A[0,4] := MUSK 
$ SHOW SYMBOL A 
A = "MUSKRAT" 

The symbol name you specify can be undefined initially. The assignment 
statement creates the symbol name and, if necessary, provides leading or 
trailing spaces in the symbol value. For example: 

$ B[4,3] := RAT 

If the symbol B does not have a previous value, it is given a value of four 
leading spaces followed by RAT. This format creates a blank line of any 
length. The following example gives the symbol LINE a value of 80 blank 
spaces: 

$ LINE[0,80]:= " " 

Lining up records in columns makes a list easier to read and sort. You can 
use this format to specify how you want data to be stored. For example: 

$ DATA[0,15] := 'NAME' 

$ DATA[17,1] := 'GRADE' 

The first statement fills in the first 15 columns of DATA with whatever value 
NAME has. The second statement fills in column 18 with whatever value 
GRADE has. Columns 16 and 17 contain blanks. 

A special format of the assignment statement can also be used to perform 
binary (bit-level) overlays of the current symbol value. This format is as 
follows: 

$ symbol-name[bit-position,size] = replacement-expression 
or 

$ symbol-name[bit-position,size] = = replacement-expression 
where: 

• bit-position is an integer that indicates the location relative to bit 0 at 
which the overlay is to occur. 

• size is an integer that indicates the number of bits to be overlaid. 

When using numeric overlays, observe the following rules: 

• The square brackets are required notation. No spaces are allowed 
between the symbol name and the left bracket. 

• Literal values are assumed to be decimal. 

• The maximum length for both bit-position and size is 32 bits. 

• The replacement-expression must be a numeric expression. 

• When symbol-name is either undefined or defined as a string, the result of 
the overlay is a string. Otherwise the result is an integer. 

The following example defines the symbol BELL as the value 7. The low- 
order byte of BELL has the binary value 00000111. By changing the 0 at 
offset 5 to 1 (beginning with 0, count bits from right to left), you create the 
binary value 00100111 (decimal value 39). 
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$ BELL = 7 
$ BELL [5,1] = 1 
$ SHOW SYMBOL BELL 

BELL = 39 Hex = 00000027 Octal = 00000000047 


5.6.2.5 Order of Operations and the Results of Evaluations 

An expression can contain any number of operations and comparisons. You 
can indicate precedence (the order in which operation and comparison should 
be evaluated) by placing operations to be performed first in parentheses. 
(Parentheses can be nested.) Otherwise, operations within an expression are 
evaluated in the following order: 

1 Unary plus ( + ) and minus (-) 

2 Multiplication and division 

3 All other numeric and character operations 

4 All numeric and character comparisons 

5 Logical NOT operations 

6 Logical AND operations 

7 Logical OR operations 

Operations and comparisons that have the same precedence are evaluated 
from left to right. The following examples illustrate precedence of operations 
in expressions: 

$ BALANCE = 150 + 20 * 4 

(BALANCE = 150 + 80) 

$ SHOW SYMBOL BALANCE 

BALANCE = 230 Hex = 000000E6 Octal = 00000000346 

$ BALANCE = (150+20) * 4 
(BALANCE = 170 * 4) 

$ SHOW SYMBOL BALANCE 

BALANCE = 680 Hex = 000002A8 Octal = 00000001250 

$ STATUS = 150 * 4 .GT. 80 * 2 
(STATUS = 600 .GT. 160) 

$ SHOW SYMBOL STATUS 

STATUS =1 Hex = 00000001 Octal = 00000000001 

An expression has either an integer or a string value, depending on the 
types of values and the operators used. The following table summarizes how 
DCL evaluates expressions. The first column lists the different values and 
operators that an expression might contain. The second column tells, for each 
case, what the entire expression is equated to. Within the table any value 
stands for a string or an integer. 

Table 5-2 Determining the Value of an Expression 

Resulting 

Expression Value Type 
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Integer value 
String value 
Integer lexical function 


Integer 

String 

Integer 
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Table 5—2 (Cont.) Determining the Value of an Expression 


Expression 

Resulting 

Value Type 

String lexical function 

String 

Integer symbol 

Integer 

String symbol 

String 

+, or .NOT. any value 

Integer 

Any value .AND. or .OR. any value 

Integer 

String + or - string 

String 

Integer + or - any value 

Integer 

Any value + or - integer 

Integer 

Any value * or / any value 

Integer 

Any value (string comparison) any value 

Integer 

Any value (numeric comparison) any value 

Integer 


















Writing and Using Command Procedures 


A command procedure is a file that contains DCL commands and data 
lines used by the DCL commands. You can write both simple and complex 
command procedures. A simple command procedure executes a series of 
DCL commands in the order in which they are written. A complex command 
procedure performs program-like functions. 


Format 

Follow these instructions when formatting a command procedure: 

• Begin each line containing a command, comment, or label with a dollar 
sign. 

• Do not begin data lines with a dollar sign. 

• Use comments to explain the command procedure to anyone who 
must maintain it. Place comments at the beginning of a procedure to 
describe the procedure and the parameters passed to it; place them at 
the beginning of each block of commands to describe that section of 
the procedure. The command interpreter ignores comments when the 
command procedure executes. Precede a comment with an exclamation 
point; the comment is all text to the right of an exclamation point. (To 
include a literal exclamation point in a command line, precede and follow 
it with quotation marks.) 

• Use complete names for commands and qualifiers. Commands and 
qualifiers are usually self-explanatory when they are not abbreviated. 
Abbreviated commands and qualifiers may no longer be unique when 
new commands and qualifiers are added to the VMS operating system. 

• Put labels on separate lines to make loops, subroutines, and conditional 
code easier to understand. (Labels mark the beginning of loops, 
subroutines, and conditional code.) You may choose to differentiate 
labels from commands by placing labels immediately after the dollar 
sign and preceding commands by a space. A label can have up to 255 
characters, cannot contain embedded blanks, and must be terminated 
by a colon. (The GOTO, GOSUB, and CALL commands transfer control 
to labels, which mark the beginning of a loop, a section of code, or a 
subroutine.) 

• Separate command sequences with lines containing a dollar sign and 
an exclamation point ($!). This makes it easier to see the outline of the 
command procedure. (If you insert blank lines, the command interpreter 
interprets them as data lines and produces a message warning you that 
the data lines were ignored. If you insert lines containing only a dollar 
sign, the command interpreter searches the whole line for a command.) 
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6.2 Execution 

Command procedures can be executed interactively from DCL level, from 
within another command procedure, on a remote node using the TYPE 
command, or in batch mode. To execute a command procedure interactively, 
type an at sign (@) followed by the file specification of the procedure. 

The file type defaults to COM. The following command executes the 
procedure SETD.COM in the directory [MAINT.PROCEDURES] on the 
disk WORKDISK: 

$ 0WORKDISK:[MAINT.PROCEDURES]SETD 

To simplify the invocation of a procedure, create a global symbol or a 
logical name, and place the symbol or logical name in your login command 
procedure. (Section 6.3 describes how to create a login command procedure. 
Symbols are described in Chapter 5. See Chapter 4 for more information 
about logical names.) Equating the command line to a global symbol allows 
you to invoke the command procedure from any directory by entering the 
global symbol name as follows: 

$ SETD == "0WORKDISK:[MAINT.PROCEDURES]SETD" 

$ SETD 

Equating the file specification to a logical name allows you to invoke the 
command procedure from any directory by entering an at sign followed by 
the logical name as follows: 

$ DEFINE SETD WORKDISK:[MAINT.PROCEDURES]SETD.COM 
$ 0SETD 

To invoke a command procedure from within another command procedure, 
use the at sign (@) followed by the file specification of the procedure. In the 
following example, the command procedure WRITEDATE.COM invokes the 
command procedure GETDATE.COM: 

$! WRITEDATE.COM 

$ INQUIRE TIME "What is the current time, in hh:mm format?" 

$ 0GETDATE 

Use the TYPE command to execute a command procedure interactively on a 
remote node. The TYPE command lets you execute command procedures to 
list the users logged on to the remote node or to display the status of services 
in the local cluster not provided clusterwide. The output of the command 
procedure is displayed on the user's terminal at the local node. 

To execute a command procedure in the default DECnet account of the 
remote node, specify the command procedure as a parameter to the TYPE 
command as follows: 

$ TYPE node_name::"TASK=command_procedure" 

The variable node—name is the name of the remote node on which the 
command procedure resides; command—procedure is the name of the command 
procedure. 

To execute a command procedure in the top level directory of another account 
on the remote node, use an access control string in the command as follows: 

$ TYPE node_name"user_name password"::"TASK=command_procedure" 

The variable user—name is the user name of the account on the remote node, 
password is the password of the account on the remote node, and 
command—procedure is the name of the command procedure. 
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The following command procedure, SHOWUSERS.COM, displays the users 
logged in at the remote node on which the command procedure resides: 

$! SHOWUSERS.COM 

$ IF F$MODE() .EQS. "NETWORK" THEN DEFINE/USER SYS$OUTPUT SYS$NET 
$ SHOW USERS 

The following command executes the command procedure 
SHOWUSERS.COM and displays the output from this command procedure 
on the user's terminal. The command procedure resides in the top level 
directory of account BIRD on node ORIOLE. 

$ TYPE ORIOLE"BIRD FLIESFAST"::"TASK=SHOWUSERS" 


VAX/VMS Interactive Users 
09-DEC-1988 17:20:13.30 
Total number of interactive users = 


Username Process Name PID 
FLICKER Freddie 00536278 

ROBIN Red 00892674 

DOVE Whitie 00847326 

DUCK Donna 02643859 


4 

Terminal 
TXA1: 
VTA2: 
TXA3: 
RTA1: 


You can also submit a command procedure to a batch queue to execute as a 
batch job. If your system is part of a network, you can submit a command 
procedure to execute as a batch job on a remote node. Within a command 
procedure, you can use DCL commands to open and close files on a remote 
node and read and write records in these files, using the same commands 
and qualifiers as for local files. Section 3.1.4 contains more information about 
batch jobs. 


6.2.1 Changing Command Levels 

A command level is an input stream for the DCL command interpreter. 

You can create a maximum of 32 command levels. There are two ways to 
create new command levels. You can either use the CALL command to call 
a subroutine that exists within the command procedure, or you can nest 
command procedures by using an execute procedure (@) command inside 
one command procedure to invoke another command procedure. When you 
use the CALL command or nest a command procedure, the command level 
increases by 1. 

When you invoke a command procedure, the command level increases by 
1. For example, if you invoke procedure SUB from DCL command level 
(level 0), SUB executes at command level 1. If SUB then invokes SUB1, 
which invokes SUBSUB1, SUB1 executes at command level 2, and SUBSUB1 
executes at command level 3. 

By convention, DCL level (command level 0) is the highest command level 
and command level 31 the lowest command level. Thus, when you move 
from command level 3 to command level 2, you are moving to the next 
higher command level. 
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6.2.2 Exiting from Command Procedures 

A command procedure exits when it reaches the end of the procedure, an 
EXIT command, or a STOP command. If the exit is caused by the end 
of the procedure or an EXIT command, control returns to the next higher 
command level. If the exit is caused by the EXIT command, you can return 
a status value to the next higher command level by specifying the value 
as the parameter of the EXIT command. (A status value is a hexadecimal 
representation of a VMS message code.) This status value is placed in the 
global symbol $STATUS. If you return the status value 44 with the EXIT 
command, control returns to DCL command level and the following error 
message is displayed: 

•/.SYSTEM-F-ABORT, abort 

See Section 5.2 for more information about the global symbols $STATUS and 
$SEVERITY. For example, if you invoke SUB at DCL command level, and 
SUB calls SUB1, the following sequence of actions occurs: 

1 Exiting from SUB1 returns you to SUB at the command line following the 
call to SUB1. 

2 Exiting from SUB returns you to DCL command level. 

If the exit is caused by the STOP command, control always returns to 
DCL command level, regardless of the command level in which the STOP 
command executes. 


6.3 Designing a Login Command Procedure 

You can create a command procedure, called a login command procedure, 
to execute the same commands each time you log in. Name your login 
command procedure LOGIN.COM, and place it in your top level directory, 
unless your system manager tells you otherwise. 

The following sample LOGIN.COM procedure illustrates some commands 
you may want to include in your login command procedure: 

$! Sample LOGIN.COM for user MARCIA with 
$! default disk of DISK3 
$! 

$! Exit if this is a batch job or another 
$! type of noninteractive process 
$! 

$ IF F$MODE() .NES. "INTERACTIVE" THEN EXIT O 
$! 

$! Tailor the default behavior of 
$! certain DCL commands 
$! 

$ PUR*GE :== PURGE/LOG 
$ SUB*MIT :== SUBMIT/NOLOG.FILE/NOTIFY 
$ M*AIL :== MAIL/EDIT=(SEND.FORWARD,REPLY) 

$! 

$! Define global symbols 
$ 1 

$ DISPLAY :== MONITOR PROCESSES/TOPCPU 
$ GO :== SET DEFAULT 
$ LP :== SHOW QUEUE/ALL SYS$PRINT 
$ SS :== SHOW SYMBOL 
$ SQ :== SHOW QUEUE/ALL 
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$ REM :== QDISK3:[MARCIA.PROG]REMINDER 
$ MAIN :== SET DEFAULT DISK3:[MARCIA] 

$! 

$! Define logical names for: 

$! Directories 
$ DEFINE HOME DISK3:[MARCIA] 

$ DEFINE REV DISK3:[MARCIA.REVIEWS] 

$ DEFINE TOOLS DISK3: [MARCIA.TOOLS] 

$! Files 

$ DEFINE EQUIP DISK3:[MARCIA.LISTSJEQUIPMENT.DAT 
$ DEFINE ACCOMP DISK3:[MARCIA]ACCOMPLISHMENTS.DAT 
$! Users 

$ DEFINE JON DAISY::HARRIS 
$ DEFINE JANE DAISY::MOORE 
$! 

$! Define keys to execute commands 
$! 

$ DEFINE/KEY PF3 "SHOW USERS" /TERMINATE 
$ DEFINE/KEY KP7 "SPAWN" /TERMINATE 
$ DEFINE/KEY KP8 "ATTACH " 

$ DEFINE/KEY KP4 "SET HOST " 

$! 

$! Change the prompt string to a three-character 
$! abbreviation of the node name 
$! 

$ NODE = F$GETSYI("NODENAME") © 

$ PROMPT = F$EXTRACT(0.3,NODE) 

$ SET PROMPT = ""PROMPT'> " 

$! 

$! Type the system notices © 

$! 

$ TYPE SYS$SYSTEM:NOTICE.TXT 
$! 

$! Run a program that displays today's appointments © 

$! 

$ RUN DISK3:[MARCIA.PROG]REMINDER 

O The F$MODE lexical function returns the mode (interactive, batch, 

network or other) that the process is in when the LOGIN.COM procedure 
is executing. This statement causes the procedure to exit unless you are 
using the system interactively. You should test the mode at the beginning 
of your LOGIN.COM procedure to ensure that commands used only in 
interactive mode are not executed in any other mode; in some cases these 
commands can abort noninteractive processes. 

© This group of commands changes the DCL prompt to the first three 
characters of the node name. The F$GETSYI lexical function determines 
the node name. The F$EXTRACT lexical function extracts the first three 
characters of the name. The SET PROMPT command changes the prompt 
from a dollar sign to the first three characters of the node name followed 
by the right-angle bracket character (> ) and a space. 

© This command displays the system notices that your system manager 
keeps in the file SYS$SYSTEM:NOTICE.TXT. 

© This command runs a user-written program that displays your daily 
appointments. If you have written programs that you always run 
after you log in, you may prefer to execute them directly from your 
LOGIN.COM file. 
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The system manager assigns the file specification for your login command 
procedure in the LGICMD field for your account. In most installations, the 
login command procedure is called LOGIN.COM. However, if you want 
to execute a file other than the one named in the LGICMD field for your 
account, use the /COMMAND qualifier when you log in. 


6.4 Passing Data 

Command procedures frequently require data provided by a user. To specify 
the same data each time the command procedure is executed, place the data 
on data lines following the command that requires the data. (A data line 
is a line that does not begin with a dollar sign. To include a data line that 
begins with a dollar sign, use the DCL commands DECK and EOD, which 
are described in the VMS DCL Dictionary.) The following command procedure 
executes the image'CENSUS.EXE, which reads the data 1981, 1982, and 1983 
each time the procedure is executed: 

$ ! CENSUS.COM 
$ ! 

$ RUN CENSUS 

1981 

1982 

1983 

$ EXIT 

The text on a data line is passed directly to the image; DCL does not process 
data lines. Therefore, DCL does not translate symbols or evaluate arithmetic 
expressions on data lines before passing the symbols or arithmetic expressions 
to the image. Logical names are not translated by DCL; therefore, a logical 
name included on a data line is translated before it is passed to an image. 

To specify different data each time a command procedure executes, use one 
of the following mechanisms, which are described in Sections 6.4.1 through 
6.4.4: 

• Pass the data as one or more parameter values. 

• Use the INQUIRE or READ command within the command procedure to 
prompt for data. 

• Specify a device or file from which to read the data by redefining the 
logical name SYS$INPUT. 


6.4.1 Using Parameters to Pass Data 

When you invoke a command procedure, you can pass it up to eight 
parameters. Place the parameters after the file specification of the command 
procedure. Separate the parameters with one or more spaces or tabs. For 
example, the following command invokes SUM.COM and passes eight 
parameters to the procedure: 

$ @SUM 34 52 664 89 2 7 87 3 

To pass parameters to a command procedure executed in batch mode, use the 
/PARAMETERS qualifier of the SUBMIT command. If you pass more than 
one parameter, place the parameters in parentheses and separate them with 
commas. If you execute more than one command procedure using a single 
SUBMIT command, the specified parameters are used for each command 
procedure in the batch job. The following command passes three parameters 
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to the command procedures ASK.COM and GO.COM, which are executed as 
batch jobs: 

$ SUBMIT/PARAMETERS=(TODAY,TOMORROW,YESTERDAY) ASK.COM, GO.COM 

DCL places parameters passed to a command procedure in the local symbols 
PI through P8; PI is assigned the first parameter value; P2 the second; P3 
the third, and so on. If you pass more than eight values, you receive the 
following error message and the command procedure does not execute: 

7.DCL-W-DEF0VF, too many command procedure parameters - limit to eight 

If you pass fewer than eight values, the extra symbols are assigned null 
values. 

Specify a parameter value as one of the following: 

• Integer—When you specify an integer, it is converted to a string as 
follows: 

$ SADDER 24 25 

In this example, PI is the string value 24; P2 is the string value 25. 

(You can, however, use the symbols PI and P2 in both integer and 
character string expressions; DCL performs the necessary conversions 
automatically.) 

• String—Specify character strings as follows: 

$ ODATA Paul Cramer 

In this example, the strings Paul and Cramer are converted to uppercase 
letters; PI is PAUL and P2 is CRAMER. 

To preserve spaces, tabs, or lowercase characters, place quotation marks 
before and after the string as follows: 

$ ODATA "Paul Cramer" 

In this example, PI is Paul Cramer and P2 is null. 

• Symbol—To pass the value of a symbol, place an apostrophe character 
before and after the symbol, as shown in the following example. When 
passing a symbol, DCL removes quotation marks that enclose a string. 
(To preserve spaces, tabs, and lowercase characters in a symbol value, 
surround the symbol with quotation marks.) 

$ NAME = "Paul Cramer" 

$ ODATA 'NAME' 

In this example, PI is Paul and P2 is Cramer. 

To include a quotation mark as part of a string, enter three quotation 
marks as follows: 

$ NEW.NAME = """Paul Cramer""" 

$ ODATA 'NEW.NAME' 

In this example, PI is "Paul Cramer" and P2 is null. 

• Null—To pass a null parameter, use a set of quotation marks as a 
placeholder in the command string. In the following example, the first 
parameter passed to DATA.COM is a null parameter: 

$ ODATA "" "Paul Cramer" 
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In the preceding example, PI is null, and P2 is Paul Cramer. 

For example, when DATA.COM is invoked with the following command, PI 
through P8 are defined in DATA.COM as follows: 

PI = Paul Cramer 
P2 = 24 

P3 = (555) 111-1111 
P4-P8 = null 

$ QDATA "Paul Cramer" 24 "(555) 111-1111" 

You can pass up to eight parameters to a nested command procedure. The 
local symbols PI through P8 in the nested procedure are not related to the 
local symbols PI through P8 in the invoking procedure. In the following 
example, DATA.COM invokes the nested command procedure NAME.COM: 

$ ! DATA.COM 
$ SNAME 'PI' Joe Cooper 

Because PI in DATA.COM is the string Paul Cramer, which contains 
no quotation marks, it is passed to NAME.COM as two parameters. In 
NAME.COM, PI through P8 are defined as follows: 

PI = PAUL 
P2 = CRAMER 
P3 = JOE 
P4 = COOPER 
P5-P8 = null 

Because DCL removes quotation marks when passing a symbol, you must 
enclose the value in three sets of quotation marks to preserve spaces, tabs, 
and lowercase characters in the symbol value. In the following example, the 
literal value in PI is enclosed in three sets of quotation marks and passed to 
NAME.COM. If PI originally contained the value "Paul Cramer", the value 
"Paul Cramer" is passed to NAME.COM. 

$ ! DATA.COM 
$ QUOTE = """ 

$ PI = QUOTE + PI + QUOTE 
$ SNAME 'PI' "Joe Cooper" 

In this example, PI is Paul Cramer and P2 is Joe Cooper in the command 
procedure NAME.COM. 

An alternative is to enclose the text in quotation marks and, where a symbol 
appears, precede the symbol with two apostrophes and follow it with one 
apostrophe as follows: 

$ ! DATA.COM 
$ SNAME ""PI"' 

Passing Data and Parameters to a Batch Job 

To specify parameters for a job submitted in batch mode, use the 
/PARAMETERS qualifier of the SUBMIT command. Note that you can 
also pass data to a batch job by including the data in a command procedure 
or by defining SYS$INPUT to be a file. The specified parameters are used for 
each command procedure in the batch job. The following SUBMIT command 
passes two parameters to the command procedures LIBRARY.COM and 
SORT.COM: 
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$ SUBMIT- 

_$ /PARAMETERS 3 (DISK:[ACCOUNT.BILLS]DATA.DAT,DISK: [ACCOUNT]NAME.DAT) - 
_$ LIBRARY.COM, SORT.COM 

Your batch job executes as if you had logged in and executed each of 
the submitted command procedures. For example, the previous SUBMIT 
command executes a batch job that logs in under your account, executes your 
login command procedure, and then executes the following commands: 

$ 8LIBRARY DISK:[ACCOUNT.BILLS]DATA.DAT DISK:[ACCOUNT]NAME.DAT 
$ 8S0RT DISK:[ACCOUNT.BILLS]DATA.DAT DISK:[ACCOUNT]NAME.DAT 


6.4.2 The INQUIRE Command 

You can use the INQUIRE command to obtain data for command procedures 
that you execute interactively. The INQUIRE command prompts for a value, 
reads the value from the terminal, and assigns it to a symbol. The response 
to the prompt is interpreted as a character string. By default, the response 
is converted to uppercase, multiple blanks and tabs are replaced by a single 
space, and leading and trailing spaces are removed. To preserve lowercase 
characters, multiple spaces, and tabs, enclose your response in quotation 
marks. The following command procedure writes the prompt Filename: and 
puts your response into the local symbol FILE: 

$ INQUIRE FILE "Filename" 

To suppress the colon and space automatically added to the end of the 
prompt, use the /NOPUNCTUATION qualifier. To make the symbol global 
instead of local, use the /GLOBAL qualifier. The following command 
procedure writes the prompt Do you want to use defaults? and puts the 
response into the global symbol DEFAULT: 

$ INQUIRE/NOPUNCTUATION/GLOBAL DEFAULT- 
_$ "Do you want to use defaults?" 

When a command procedure is submitted as a batch job, the value for 
a symbol specified in an INQUIRE command is read from the data line 
following the INQUIRE command. If you do not include a data line, the 
symbol is assigned a null value. 


6.4.3 The READ Command 

You can use the READ command to obtain data for command procedures that 
you execute interactively. The READ command prompts for a value, reads 
the value from the source specified by the first parameter, and assigns it to the 
symbol named as the second parameter. If you do not specify a prompt, the 
READ command outputs DATA: as the default prompt. To specify a different 
prompt, use the /PROMPT qualifier. All characters typed on the terminal 
in response to the prompt are taken as an exact character string value (case, 
spaces, and tabs are preserved). The following command writes the prompt 
Filename:, reads the response from the source specified by the logical name 
SYS$COMMAND (by default, the terminal), and assigns the response to the 
symbol FILE: 

$ READ/PROMPT="Filename: " SYS$C0MMAND FILE 
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6.4.4 Obtaining Data from SYS$INPUT 

Commands, utilities, and other system images usually take their input from 
the source specified by the logical name SYS$INPUT. SYS$INPUT is a 
process-permanent logical name that the system defines automatically. You 
can specify SYS$INPUT as any one of the following: 

• Data line—In a command procedure, the default value of SYS$INPUT is 
the data lines of the procedure. In the following command procedure, the 
image CENSUS.EXE uses the default value of SYS$INPUT to take input 
(1986, 1987, and 1988) from the data lines: 

$ ! CENSUS.COM 
$ ! 

$ ! Execute CENSUS 
$ RUN CENSUS 

1986 

1987 

1988 
$ 

• Terminal—A command procedure can get input from a terminal by 
defining SYS$INPUT as the terminal. This allows you to perform 
interactive tasks from a command procedure. The following command 
procedure defines SYS$INPUT as SYS$COMMAND, which is, by default, 
the terminal. The command procedure then invokes the EDT editor, 
beginning an interactive editing session. (The /USER-MODE qualifier 
redefines SYS$INPUT for a single image; you should use this qualifier 
whenever you redefine a process-permanent logical name.) 

$ ! EDIT.COM 
$ ! 

$ ! Edit the file STATS.DAT 
$ WRITE SYS$0UTPUT "Edit STATS.DAT:" 

$ DEFINE/USER.MODE SYS$INPUT SYS$C0MMAND: 

$ EDIT STATS.DAT 

• File—A command procedure can get input from a file by defining 
SYSSINPUT as a file. The following command procedure defines 
SYS$INPUT as the file YEARS.DAT, then invokes the program CENSUS. 
CENSUS reads its input from the file YEARS.DAT. 

$ ! CENSUS.COM 
$ ! 

$ ! Execute CENSUS 

$ DEFINE/USER_M0DE SYS$INPUT YEARS.DAT 
$ RUN CENSUS 
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6.5 Returning Data 

To return a value from a command procedure (either to a calling procedure or 
to DCL command level), you must assign the value to a global symbol. The 
global symbol can be read at any command level. Use comments to explain 
the use of any global symbols. 

To create a global symbol, specify the value to be passed on the right side of 
a global assignment statement. In the following example, the command 
procedure DATA.COM invokes the command procedure NAME.COM, 
passing NAME.COM a full name. NAME.COM places the last name in the 
global symbol LAST_NAME. When NAME.COM completes, DCL continues 
executing DATA.COM, which reads the last name by specifying the global 
symbol LAST-NAME. (The command procedure NAME.COM would be in a 
separate file; it is indented here for clarity.) 

$ ODATA "Paul Cramer" 

$ ! DATA.COM 
$ ! 

$ ! PI is a full name 

$ ! NAME.COM returns the last name in the 
$ ! global symbol LAST_NAME 
$ ! 

$ 0NAME 'Pi' 

$ ! NAME.COM 
$ ! PI is a first name 
$ ! P2 is a last name 

$ ! return P2 in the global symbol LAST.NAME 
$ LAST_NAME == P2 
$ EXIT 

$ ! write LAST_NAME to the terminal 
$ WRITE SYS$OUTPUT "LAST.NAME = "LAST.NAME"’ 

LAST.NAME = CRAMER 


6.6 Displaying Data 

Commands, utilities, and other system images normally write their output 
to the source specified by the logical name SYS$OUTPUT. By default, 
SYS$OUTPUT is equated to the terminal. However, you can redirect the 
output of a command procedure to a file by using the /OUTPUT qualifier. In 
the following example, output from the command procedure SETD.COM is 
written to the file RESULTS.TXT instead of to the terminal: 

$ QSETD/OUTPUT=RESULTS.TXT 

DCL commands that accept the /OUTPUT qualifier include: ACCOUNTING, 
CALL, DIRECTORY, HELP, LIBRARY, RUN (process), SPAWN, and TYPE. 
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6.6.1 Displaying Character Strings and Symbols 

To display character strings and symbols on the terminal, use the WRITE 
command as follows: 

• Character string—Enclose the text to be displayed in quotation marks. 
The following example displays the text: Two files were written. 

$ WRITE SYSSOUTPUT "Two files were written." 

• Symbol value—The WRITE command automatically substitutes 
symbols and lexical functions. The following example displays the 
text STAT1.DAT, which is the translation of the symbol FILE: 

$ FILE = "STAT1.DAT" 

$ WRITE SYSSOUTPUT FILE 

• Combination of character strings and symbol values—Enclose the text to 
be displayed in quotation marks. Preface a symbol with two apostrophes, 
and follow it with one apostrophe. The following example displays 

the text: STAT1.DAT and STAT2.DAT were written. STAT1.DAT is the 
translation of the symbol AFILE; STAT2.DAT is the translation of the 
symbol BFILE. 

$ AFILE = "STAT1.DAT" 

$ BFILE = "STAT2.DAT" 

$ WRITE SYSSOUTPUT ""AFILE' and "BFILE’ were written." 

You can also use commas and quotation marks to display a combination 
of character strings and symbol values. The following example displays 
the same text as the previous example: 

$ AFILE = "STAT1.DAT" 

$ BFILE = "STAT2.DAT" 

$ WRITE SYSSOUTPUT AFILE. " and " .BFILE. " were written." 


6.6.2 Displaying Text 

To display text that is more than one line long, use the TYPE command. 
TYPE writes data to SYSSOUTPUT (the terminal, by default). Using 
SYS$INPUT as the parameter causes TYPE to read the data from the 
command procedure. When the following command procedure is executed, 
the text on the data lines is displayed on the terminal: 

$ ! CLEAN.COM 
$ ! 

$ TYPE SYSSINPUT 

This command procedure executes a command that allows you 
to clean up a directory. 

Please enter one of the following commands after the prompt: 

EXIT. DIRECTORY. TYPE, PURGE. DELETE. COPY 

$ INQUIRE COMMAND "Command" 


6-12 











Writing and Using Command Procedures 

6.6 Displaying Data 


6.6.3 Displaying Files 

To display the contents of a file, use the TYPE command. The following 
example displays the file STAT1.DAT on the terminal: 

$ TYPE DUAO:[HORACE]STAT1.DAT 


6.7 Reading and Writing Files (File I/O) 

To move data to and from files, use the OPEN, CLOSE, READ, and WRITE 
commands. The logical name you specify in the OPEN command is used to 
refer to the file in the WRITE, READ, and CLOSE commands. 


6.7.1 Specifying Files in Batch Job Command Procedures 

A batch job command procedure executes as if you had logged in and 
executed the command procedure interactively. Since your login default 
directory is not usually the default directory needed to access files mentioned 
in a command procedure, command procedures that will be executed in batch 
mode should use one of the following mechanisms to ensure that the correct 
files are accessed: 

• Use complete file specifications—When specifying a file in a command 
procedure or passing a file to a command procedure, include the device 
and directory names as part of the file specification, as shown in the 
previous example. 

• Use the SET DEFAULT command—Before accessing a file in a command 
procedure, use the SET DEFAULT command to specify the proper device 
and directory. 


6.7.2 Writing to a File 

To write data to a file, take the following steps: 

1 Open the file—The OPEN command assigns to the logical name specified 
in the first parameter the file name specified in the second parameter. 

Use the /APPEND qualifier of the OPEN command to write data to 
the end of an existing file. If you use the /APPEND qualifier to open a 
nonexistent file, an error occurs and no file is opened. 

Use the /WRITE qualifier of the OPEN command to create a new file and 
to open this file for write access. If you use the /WRITE qualifier to open 
an existing file, a new version of that file is created. 

2 Begin the write loop with a label—File I/O is always done in a loop 
unless you are writing or reading a single record. 

3 Read the data to be written—Use the INQUIRE command or the READ 
command to read data into a symbol. 

4 Test the data—Check the symbol containing the data. If the symbol is 
null (you pressed RETURN and entered no data on the line), you have 
reached the end of the data to be written to the file and should go to the 
end of the loop. Otherwise, continue. 
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5 Write the data to the file—Use the WRITE command to write the value of 
the symbol (one record) to the file. 

6 Return to the beginning of the loop—You remain in the loop until there 
is no more data to be written to the file. 

7 End the loop and close the file—The CLOSE command disassociates the 
file name from the logical name and closes the file. (Files opened by the 
OPEN command remain open until you log out unless you explicitly close 
them.) 


The following command procedure writes data to the new file STAT.DAT. If a 
file of that name exists, a new version is created. 


$ ! Write a file 
$ ON ERROR THEN EXIT 
$ 

$ OPEN/WRITE IN.FILE STAT.DAT 
$ ON CONTROLS THEN GOTO END.WRITE 
$ 

$ ON ERROR THEN GOTO END.WRITE 
$ 


IEXIT if the command procedure 
! cannot open the file 
!0pen the file 

!Close the file if you abort 
! execution with a CTRL/Y 
!Close the file if an error 
! occurs 
!Begin loop 
!Get input 

ITest for end of file 
IWrite to the file 
IGoto beginning 
!End loop 

!Close the file 


SWRITE: 

$ INQUIRE STUFF "Input data" 

$ IF STUFF .EQS. "" THEN GOTO END.WRITE 
$ WRITE IN.FILE STUFF 
$ GOTO WRITE 
SEND.WRITE: 

$ ! 

$ CLOSE IN.FILE 


Note: The logical name in the OPEN command must be unique. If the OPEN 
command does not work and your commands seem correct, change the 
logical name in the OPEN command. Use the SHOW LOGICAL command 
to display logical name definitions. 

If you want to create a file with a unique name, use the F$SEARCH lexical 
function to see whether the name is already in the directory. (See the lexical 
function descriptions in the DCL Commands section for more information 
about F$SEARCH.) The following command procedure prompts the user for 
a file name, then uses the F$SEARCH lexical function to search the default 
directory for the name. If a file with that name already exists, control is 
passed to ERROR-1, the procedure prints the message File already exists, and 
control returns to the label GET-NAME. You are again prompted for a file 
name. 


$ ! FILES.COM 
$ ! 

$GET_NAME: 

$ INQUIRE FILE "File" ! Get a file name 

$ CHECK = F$SEARCH (FILE) ! Make sure the file name is unique 

$ IF CHECK .NES. "" THEN GOTO ERROR. 1 

$ OPEN/WRITE IN.FILE 'FILE' ! Open and write to the file 


$ EXIT 
$ERROR.1: 

$ WRITE SYS$OUTPUT "File already exists" 
$ GOTO GET.NAME 
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6.7.3 Reading from a File 

To read data from a file, take the following steps: 

1 Open the file—The OPEN/READ command opens the file for read access 
and associates the file name with a logical name. 

2 Begin the read loop File I/O is always done in a loop unless you are 
reading or writing a single record. 

3 Read the data from the file—Use the READ command with the 
/END_OF_FILE qualifier to read the next record in the file to a symbol. 
The /END_OF_FILE qualifier causes the VMS system to pass control to 
the label specified by the /END_OF_FILE qualifier when you reach the 
end of the file. Generally, you specify the label that marks the end of the 
read loop. 

4 Process the data—When you read a file sequentially, process the current 
record before reading the next one. 

5 Return to the beginning of the loop—You remain in the loop until you 
reach the end of the file. 

6 End the loop and close the file—The CLOSE command disassociates the 
file name from the logical name and closes the file. 

The following command procedure reads and processes each record in the file 
STAT.DAT: 

$ OPEN/READ 0UT_F STAT.DAT !0pen the file 

$ ! 

$READ_DATA: !Begin the loop 

$ READ/END_OF_FILE=END_READ OUT.F STUFF IRead a record; test for 
$ ! end of file 

$ ! Process the data 


$ GOTO READ_DATA 
$ 

$END_READ: 

$ ! 

$ CLOSE 0UT_F 


•Go to the beginning 
! of the loop 
!End of loop 

IClose the file 


6.7.4 Modifying a File 

You can modify a file in the following ways: 

• Rewrite records—This method allows you to make minor changes to a 
small number of records in a file. You cannot change the size of a record 
or the number of records in the file. 

• Rewrite the file—This method allows you to change, delete, and insert 
records. You create a new file using the old file as the main source of 
input. 

• Append records to a file—This method allows you to add new records to 
the end of the file. 
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6.7.4.1 Minor Modifications 

To make minor changes to the records in a file, take the following steps. 

1 Open the file for both read and write access. 

2 Use the READ command to read through the file until you reach the 
record that you want to modify. 

3 Create a symbol containing the modified record. The modified record 
must be exactly the same size as the original record. If the text of the 
modified record is shorter, pad the record with spaces. If the text of the 
modified record is longer, you cannot use this method to modify the file. 

4 Use the WRITE/UPDATE command to write the modified record back to 
the file. 

5 Repeat steps 2 through 4 until you have changed all records you intend 
to change. 

6 Close the file. 

Since this method does not allow you to modify the size of the record, use it 
only if you have formatted the records in a file (for example, in a data file). 

The following command procedure reads each record in a data file. The 
record is displayed on the terminal, and you are asked whether the record is 
to be modified. If you choose to modify the record, a new record is read from 
the terminal, and its length is compared to the length of the original record. 

If the original record is longer, the new record is padded with spaces. If the 
original record is shorter, an error message is displayed, and you are again 
prompted for a new record. If you choose not to modify the record, the next 
record is read from the file. 

$ ! MODIFY.COM 
$ ! 

$ SPACES = " " ! Initialize string of spaces 

$ ! for padding 

$ ! 

$ OPEN/READ/WRITE FILE STATS.DAT ! Open the file 
$ 1 

$BEGIN_L00P: ! Begin the loop 

$ ! 

$ READ/END_0F_FILE=END_L00P FILE RECORD ! Read and display a record 
$PR0MPT: 

$ WRITE SYS$0UTPUT RECORD 
$ ! 

$ ! Does the user want to change the record? 

$ INQUIRE/NOPUNCTUATION YN "Change? [Y] " 

$ IF YN .EQS. "N" THEN GOTO BEGIN.LOOP ! If not, get next record 
$ INQUIRE NEW_REC0RD "New record" ! Otherwise, get the new record 

$ ! 
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o 



$ 0LD_LEN F$LENGTH (RECORD) ! Compare the old and new records 

$ IF OLD.LEN .GE. F$LENGTH(NEW_RECORD) THEN GOTO NO.ERROR 
$ ! New record longer than old record 

$ WRITE SYS$OUTPUT "ERROR — New record is too long" 

$ GOTO PROMPT 
$ ! 

$N0_ERR0R: 

$ IF 0LD_LEN .EQ. F$LENGTH(NEW_RECORD) THEN GOTO WRITE.RECORD 
$ ! New record shorter than old record 
$ PAD = F$EXTRACT(0,OLD_LEN-F$LENGTH(NEW_RECORD).SPACES) 

$ NEW.RECORD = NEW.RECORD + PAD 
$ ! 

$WRITE_RECORD: ! Write the new record 

$ WRITE/UPDATE FILE NEW_RECORD 
$ GOTO BEGIN.LOOP 
$ ! 

$END_L00P: 

$ CLOSE FILE 
$ EXIT 


6.7.4.2 Major Modifications 

To make extensive changes to a file, open that file for read access and open 
a new file for write access. Since the /WRITE qualifier opens a new file for 
write access, the new file can have the same name as the original file. The 
new file has a version number one greater than the version number of the old 
file. 

Note: You must open the existing file for read access before you open the 

new version for write access to ensure that the correct file is opened for 
reading. 

To make major modifications to a file, take the following steps: 

1 Open the file for read access. This is the file you are modifying. 

2 Open a new file for write access. 

3 Use the READ command to read each record from the file you are 
modifying. 

As you read each record from the original file, decide how the record is to 
be treated. In the following examples, the symbol RECORD contains the 
record read from the original file: 

• No change—Write the same symbol to the new file. 

$ ! No change 
$ WRITE NEW.FILE RECORD 

• Change—Use the INQUIRE command to read a different record into 
the symbol, then write the modified symbol to the new file. 

$ ! Change 

$ INQUIRE NEW.RECORD "New record" 

$ WRITE NEW.FILE NEW.RECORD 

• Delete—Do not write the symbol to the new file. 

• Insert—Use a loop to read records into the symbol and to write the 
symbol to the new file, as shown in the following example: 
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$ ! Insertion 
$L00P: 

$ !Get new records to insert 
$ INQUIRE NEVLRECORD "New record" 

$ IF RECORD .EQS. "" THEN GOTO END_L00P 
$ WRITE NEW.FILE NEW.RECORD 
$ GOTO LOOP 
$END_L00P: 

4 Continue reading and processing records until you have finished. 

5 Use the CLOSE command to close both the input and the output files. 


6.7.4.3 Appending Records to a File 

The OPEN/APPEND command allows you to append records to the end of 

an existing file. Use the following steps to append records to a file: 

1 Use the OPEN command with the /APPEND qualifier to position the 
record pointer at the end of the file. The /APPEND qualifier does not 
create a new version of the file. 

2 Use the WRITE command to write new data records. Continue adding 
records until you are through. 

3 Use the CLOSE command to close the file. 


6.7.5 Handling Input/Output (I/O) Errors 

Use the /ERROR qualifier with the OPEN, READ, or WRITE command to 
suppress error messages and to pass control to a specified label if an error 
occurs during an input or output operation. This qualifier overrides all other 
error-control mechanisms (except the /END_OF_FILE qualifier on the READ 
command). In the following command procedure, if an error occurs during 
execution of the OPEN command, the message Error opening STAT.DAT is 
printed and the procedure exits: 

$ OPEN/READ/ERROR=READ_ERR 0UT_F STAT.DAT 


$ EXIT 
$READ_ERR: 

$ WRITE SYS$OUTPUT "Error opening STAT.DAT" 
$ EXIT 


6.8 Complex Command Procedures 

Complex command procedures perform programlike functions. You can use 
variable input in a complex command procedure, execute sections of the 
procedure only if certain conditions are true, execute subroutines, or invoke 
other command procedures. The following sections describe how to design, 
code, and test complex command procedures. 


6-18 












Writing and Using Command Procedures 

6.8 Complex Command Procedures 


6.8.1 


Designing Complex Command Procedures 


Before writing a complex command procedure, perform the tasks interactively 
that the command procedure will execute. As you type the necessary 
commands, note the following: 

• Variables—Data that changes each time you perform the task. 

• Conditionals—Any command or set of commands that may vary each 
time you perform the task. Note the commands and the conditions under 
which you would execute them. 

• Iteration—Any command or set of commands that you repeat. Note the 
commands and the factor that controls how often you repeat them. 

The following example shows the commands needed to clean up a directory: 


COMMAND VARIABLE 


REPEAT 

UNTIL 

DONE 


“l 

DIRECTORY 

or 

TYPE filename 
or 

PURGE filename 
or 

DELETE filename 
or 

COPY filename newname 


CONDITION 

- TO DISPLAY NEW FILE NAMES 

- TO DISPLAY A FILE 

- TO PURGE A FILE 

- TO DELETE A FILE 

- TO COPY A FILE 


ZK-1750-84 


The file names change each time you clean your directory; therefore, they are 
variables. Any or all of the commands may be executed depending on the 
operation you need to perform; therefore, each command is conditional. The 
entire process is repeated until the directory is clean; therefore, it is iterative. 

You must decide how to load the variables, test the conditionals, and exit 
from the loop. For the directory cleaning procedure, the following design 
decisions were made: 

• Load variables—The command procedure gets the file names from the 
terminal. 

• Test conditionals—The command procedure gets a command name 
from the terminal and executes the appropriate statements based on the 
command name. The first two characters of each command must be read 
to differentiate between DELETE and DIRECTORY. 

• Exit from loop—You must enter the EXIT command to exit from the loop. 
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Procedures 


Complete the design as follows: 




GET command 



If command begins with Dl 
DIRECTORY 



If command begins with TY 

GET filename 

TYPE filename 



If command begins with PU 

GET filename 

PURGE filename 



If command begins with DE 

GET filename 

DELETE/CONFIRM filename 



If command begins with CO 

GET filename 

GET newname 

COPY filename newname 



If command begins with EX 

EXIT 



ZK-1751-84 





6.8.2 Coding Complex Command Procedures 


To make the command procedure easier to understand and to maintain, try 
to write the statements so that the procedure executes in a linear fashion, 
from the first command to the last command. The following sections describe 
how to execute conditional code and loops. (See Section 5.6.2 for information 
about the logical operators used in condition expressions.) 
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6.8.2.1 



The IF Command 

The IF command tests the value of an expression and causes different 
commands to execute when the expression is true and when it is false. 

DCL provides two distinct formats for the IF command. The first format 
executes a single command when the condition specified to the IF command 
is true as follows: 

$ IF condition THEN command 

DCL also provides a block-structured IF format. The block-structured IF 
command executes more than one command if the condition is true and 
accepts an optional ELSE statement that executes one or more commands 
if the condition is false. To execute more than one command upon a true 
condition, specify the THEN statement as a verb (a DCL command preceded 
by a dollar sign) and terminate the resulting block-structured statement with 
an ENDIF statement as follows: 

$ IF condition 
$ THEN command 
$ command 


$ ENDIF 


To execute one or more commands upon a false condition, specify the ELSE 
statement as a verb and terminate the resulting block-structured statement 
with an ENDIF statement as follows: 


$ IF condition 
$ THEN command 
$ command 


$ ELSE command 
$ command 



$ ENDIF 


Command blocks can be executed in several ways, depending on whether 
you leave the commands in the same command procedure or put them in 
another command procedure and execute them there: 

• If you leave the commands in the command procedure, place them after 
the THEN statement. 

$ IF condition 
$ THEN command 
command 


$ ENDIF 



6-21 









Writing and Using Command Procedures 

6.8 Complex Command Procedures 


• If you place the commands in a separate procedure, make the call to that 
command procedure as part of the THEN statement. 

$ IF condition 
$ THEN @command_procedure 
$ ELSE command 
$ command 

$ ENDIF * 

You can continue to specify the nonblock structured IF format and direct flow 
to a labeled region when the condition specified is met as follows: 

$ IF not condition THEN GOTO END_LABEL 


$END_LABEL: 

In the following example, a specified file is purged if COMMAND equals 
"PU". If COMMAND does not equal "PU", a specified file is printed. 

$! Purge a file. If no file exists, print the requested file. 

$ IF COMMAND .EQS. "PU" 

$ THEN 

$ INQUIRE FILESPEC "File to purge" 

$ PURGE 'FILESPEC' 

$ ELSE 

$ INQUIRE FILESPEC "File to print" 

$ PRINT 'FILESPEC' 

$ ENDIF 

$! Type a file. If no file exists, exit" 

$ IF COMMAND .EQS. "TY" 


$ EXIT 

In the following example, the command procedure SCREEN_SETUP.COM is 
executed if F$MODE() equals "INTERACTIVE". If F$MODE() does not equal 
"INTERACTIVE", the procedure exits. (The command procedure 
SCREEN_SETUP.COM would be in a separate file; the commands it contains 
are indented here for clarity.) 

$ IF F$MODE() .EQS. "INTERACTIVE" 

$ THEN 

$ aSCREEN.SETUP 

$ ! SCREEN_SETUP.COM 
$ ! Set terminal characteristics 
$ SET TERMINAL/DEVICE=VT200 
$ SET TERMINAL/WIDTH=132 
$ ! Invoke Editor 
$ EVE :== EDIT/TPU 
$ ELSE 
$ EXIT 
$ ENDIF 
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6.8.2.2 Case Statements 

A case statement is a special form of conditional code that executes one out of 
a set of command blocks, depending on the value of a variable or expression 
Typically, the valid values for the case statement are labels at the beginning 
of each command block. The case statement passes control to the appropriate 
block of code by using the specified value as the target label in a GOTO 
statement. 

To write a case statement: 

1 List the labels—Equate a symbol to a string that contains a list of the 
labels delimited by slashes (or any character you choose to act as a 
delimiter). This symbol definition should precede the command blocks. 

$ COMMAND.LIST = "/PURGE/DELETE/EXIT/" 

2 Write the "case statement"—First, use the INQUIRE command to get the 
value of the case variable. Next, use the IF command with F$LOCATE 
and F$LENGTH to determine whether the value of the case variable is 
valid. If the case variable is valid, execute the case statement (a GOTO 
command) to pass control to the appropriate block of code. Otherwise, 
display a message and exit or request a different case value. 

In the following example, the label is equated to the full command 
name. Therefore, F$LOCATE includes the delimiters in its search for the 
command name to ensure that the command is not abbreviated. 

$GET_COMMAND: 

$ INQUIRE COMMAND - 

"Command (EXIT,PURGE,DELETE)" 

$ IF F$L0CATE ("/"+C0MMAND+"/",COMMAND_LIST) .EQ. - 
F$LENGTH (COMMAND_LIST) THEN GOTO ERROR,1 
$ GOTO 'COMMAND' 


$ERR0R_1: 

$ WRITE SYS$OUTPUT "No such command as ''COMMAND"' 

$ GOTO GET.COMMAND 

3 Write the command blocks—Each block of commands may contain one 
or more commands. Begin each command block with a unique label. 
End each command block by passing control to a label outside the list of 
command blocks. 

$GET_COMMAND: 


SPURGE: 

$ INQUIRE FILE 
$ PURGE 'FILE' 

$ GOTO GET_COMMAND 
$ ! 

SDELETE: 

$ INQUIRE FILE 
$ DELETE 'FILE' 

$ GOTO GET.COMMAND 
$ ! 

SEXIT: 
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6.8.2.3 


Loops 

A loop is a group of commands that executes repeatedly until a condition is 
met. The following arrangement is recommended for statements that form a 
loop: 

1 Begin the loop. 

2 Change the termination variable. 

3 Test the termination variable. If the condition is met, go to the end of the 
loop. 

4 Perform the commands in the body of the loop. 

5 Return to the beginning of the loop. 

6 End the loop. 

You can also write loops that test the termination variable at the end of the 
loop rather than at the beginning as follows: 

1 Begin the loop. 

2 Perform the commands in the body of the loop. 

3 Change the termination variable. 

4 Test the termination variable. If the condition is not met, go to the 
beginning of the loop. 

5 End the loop. 

Note that when you test the termination variable at the end of the loop, the 
commands in the body of the loop execute at least once, regardless of the 
value in the termination variable. 

Both of the following examples execute a loop that terminates when 
COMMAND equals "EX" (EXIT). (F$EXTRACT truncates COMMAND to 
its first two characters.) In the first example, COMMAND, the termination 
variable, is tested at the beginning of the loop; in the second, it is tested at 
the end of the loop. 

$ ! EXAMPLE 1 
$ ! 

$GET_COMMAND: 

$ INQUIRE COMMAND- 

"Command (EXIT,DIRECTORY,TYPE.PURGE,DELETE.COPY)" 

$ COMMAND = F$EXTRACT(0,2,COMMAND) 

$ IF COMMAND .EQS. "EX" THEN GOTO END.L00P 


$ GOTO GET.COMMAND 
$END_L00P: 
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EXAMPLE 2 


$GET_COMMAND: 

$ INQUIRE COMMAND- 

"Command (EXIT,DIRECTORY.TYPE.PURGE,DELETE,COPY)" 
$ COMMAND = F$EXTRACT(0,2,COMMAND) 



$ IF COMMAND .NES. "EX" THEN GOTO GET.COMMAND 
$ ! End of loop 

To perform a loop a specific number of times, use a counter as the termination 
variable. In the following example, 10 file names are input by the user and 
placed into the local symbols FIL1, FIL2, ..., FIL10: 

$ NUM = 1 i Set counter 

$L00P: j Begin loop 

$ INQUIRE FIL'NUM' "File" ! Get file name 

$ NUM = NUM + 1 ! Update counter 

$ IF NUM .LT. 11 THEN GOTO LOOP ! Test for termination 
$END_L00P: | End loop 




6 . 8 . 2.4 



To perform a loop for a known sequence of values, use F$ELEMENT. In the 
following example, the files CHAP1, CHAP2, CHAP3, CHAPA, CHAPB, and 
CHAPC are processed in order. 

$ FILE.LIST = "1,2,3,A,B,C" 

$ INDEX = 0 
SPROCESS: 

$ NUM = F$ELEMENT(INDEX,",",FILE_LIST) 

$ IF NUM .EQS. "," THEN GOTO END.L00P 
$ FILE = "CHAP"NUM"' 

$ ! process file named by FILE 


$ INDEX = INDEX + 1 
$ GOTO PROCESS 
$END_L00P: 

$ EXIT 


Subroutines 

Use the GOSUB command or the CALL command to transfer control to a 
subroutine within a command procedure. The GOSUB command transfers 
control to a labeled subroutine in a command procedure without creating 
a new procedure level. Since the GOSUB command does not create a new 
command level, it is referred to as a local subroutine call. The RETURN 
command terminates the GOSUB subroutine procedure, returning control to 
the command following the calling GOSUB statement. 
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The following command procedure shows how to use the GOSUB command 
to transfer control to labeled subroutines: 

$! 

$! GOSUB.COM 
$! 

$ SHOW TIME 
$ GOSUB TEST1 

$ WRITE SYS$0UTPUT "success completion" 

$ EXIT 
$! 

$! TEST1 GOSUB definition 
$! 

$ TEST1* 

$ WRITE SYSSOUTPUT "This is GOSUB level 1." 

$ GOSUB TEST2 

$ RETURN 

$! 

$! TEST2 GOSUB definition 
$! 

$ TEST2* 

$ WRITE SYS$OUTPUT "This is GOSUB level 2." 

$ RETURN 

The CALL command transfers control to a labeled subroutine in a command 
procedure and creates a new command level. The CALL command allows 
you to keep more than one related command procedure in a single file, 
making the procedures easier to manage. You can pass up to eight parameters 
to the subroutine; you can create up to 32 command levels with the CALL 
command. 

By default, the CALL command sends output to SYS$OUTPUT. The optional 
/OUTPUT qualifier allows you to direct output from the subroutine to a file. 
Do not use wildcard characters in the output file specification. The default file 
type for the output file is LIS. 

Unless they are masked using the SET SYMBOL command, local symbols 
defined in an outer level are available to any inner procedure or subroutine 
levels and global symbols are available at any command level. Labels are 
valid only for the level in which they are defined. 

The SUBROUTINE and ENDSUBROUTINE commands define the beginning 
and end of a subroutine invoked with the CALL command. The label 
defining the entry point to the subroutine immediately precedes the 
SUBROUTINE command. The ENDSUBROUTINE command functions as 
an EXIT command if an EXIT command is not specified in the procedure. The 
ENDSUBROUTINE command terminates the subroutine and transfers control 
to the command line immediately following the CALL command. 

Command lines in a CALL subroutine execute only when the subroutine is 
called with the CALL command. During the line-by-line execution of the 
command procedure, the command language interpreter skips all commands 
between the SUBROUTINE and the ENDSUBROUTINE commands. 

The following procedure shows how to use CALL to transfer control to 
a labeled subroutine. The example also shows that you can call another 
command procedure from within a subroutine. (You can also call another 
subroutine from a subroutine.) The CALL command invokes the subroutine 
SUB1, directing output to the file NAMES.LOG and allowing other users 
write access to the file. 
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$! 

$! CALL.COM 
$! 

$! Define subroutine SUB1 
$! 

$ SUB1: SUBROUTINE 


$ @FILE 


!Invoke another command procedure 


$ EXIT 

$ ENDSUBROUTINE !End of SUB1 definition 
$! 

$! Start of main routine. At this point, SUB1 has 
$! been defined, but none of the commands in the 
$! subroutine have executed. 

$! 

$ START: 

$ CALL/OUTPUT=NAMES.LOG SUB1 "THIS IS PI" 


$ EXIT !Exit this command procedure file 


6.8.3 Testing and Debugging 

For lengthy or complex command procedures, write the logic for the main 
procedure, but use stubs for the nested procedures and subroutine-type pieces 
of code. A stub is a command that writes a message stating the function it is 
replacing. For example, the following stub replaces the purge routine: 


$ ! Purge a file 

$ IF COMMAND .NES. "PU" THEN GOTO END_PURGE 
$ WRITE SYS$OUTPUT "Purge routine" ! stub 
$END_PURGE: 


If you have a number of places that need stubs, you can use one nested 
command procedure to insert the stub logic as follows. (The command 
procedure STUB.COM would be in a separate file; it is indented here for 
clarity.) 
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$ ! Purge a file 

$ IF COMMAND .NES. "PU" THEN GOTO END_PURGE 
$ ©STUB "Purge" 

$ ! STUB.COM 

$ ! Procedure STUB 

$ WRITE SYSSOUTPUT '"'PI' routine" 

$END_PURGE: 


Once you have written the code using stubs, you can test the overall logic of 
the command procedure as follows. Test all possible paths of execution. 

$ ! CLEAN.COM 
$ ! 

$GET_C0MMAND: 

$ ! Read a command from the terminal 
$ INQUIRE COMMAND- 

"Command (EXIT. DIRECTORY, TYPE, PURGE, DELETE, COPY)" 

$ COMMAND = F$EXTRACT(0.2,COMMAND) 

$ ! 

$ IF COMMAND .EQS. "EX" THEN GOTO END_COMMAND 
$ ! 

$ ! Purge a file 

$ IF COMMAND .NES. "PU" THEN GOTO ENDJPURGE 
$ WRITE SYSSOUTPUT "Purge routine." 

SEND.PURGE: 

$ ! 

$ ! Delete a file 

$ IF COMMAND .NES. "DE" THEN GOTO END.COMMAND 
$ WRITE SYSSOUTPUT "Delete routine." 

$ END.DELETE: 


$ GOTO GET_COMMAND 
SEND.COMMAND: 

Once the overall logic of the procedure works, you can begin filling in the 
stubs. Fill in the first stub, test it, and debug it if necessary. When that stub 
works, move on to the next one. 

The following commands are useful for debugging command procedures: 

• SET VERIFY—SET VERIFY prints each line before it is executed. When 
an error occurs with verification set, you see the error and the line that 
generated the error. In the following example, seeing the command line 
that generated the error explains the error message. 
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$ SET VERIFY 
$ OCDIR 

$ ! Read a command from the terminal 
$ INQUIRE COMMAND- 

"Command (EXIT, DIRECTORY, TYPE, PURGE, DELETE, COPY)" 
Command (EXIT, DIRECTORY, TYPE, PURGE, DELETE, COPY): DELETE 
$ COMMAND = F$EXTRACT(0,2,COMMAND) 

$GET_COMMAND: 

$ IF COMMAND .EQ. "EX" THEN GOTO END.COMMAND 
7.DCL-W-IVCHAR, non-numeric character in value string 
\E\ EXIT 

$ IF COMMAND .NES. "DI" THEN GOTO END.DIR 


The logical operator .EQ. is used to compare numbers, not strings (see 
Section 5.6.2 for information about logical operators). To correct the error, 
change .EQ. to .EQS.. Note that you can use keywords with SET VERIFY 
to indicate that only command lines or data lines are to be verified. 

• SHOW SYMBOL—Use the SHOW SYMBOL command to print the values 

of the symbols involved in an error. In the following procedure, the IF 
statements are not passing control to the expected procedures. Putting the 
command SHOW SYMBOL COMMAND before the IF statements allows 
you to check the value of COMMAND. 

$ SET VERIFY 
$ 0CDIR 
$GET_C0MMAND: 

$ ! Read a command from the terminal 
$ INQUIRE COMMAND- 

"Command (EXIT. DIRECTORY. TYPE, PURGE, DELETE, COPY)" 

Command (EXIT, DIRECTORY, TYPE, PURGE, DELETE, COPY): DELETE 
$ COMMAND = F$EXTRACT(1,2,COMMAND) 

$ SHOW SYMBOL COMMAND 
COMMAND = "EL" 

$GET_COMMAND: 

$ IF COMMAND .EQS. "EX" THEN GOTO END.COMMAND 


The F$EXTRACT lexical function is extracting two characters beginning 
at character 1 (the second character) rather than at character 0 (the first 
character). To correct the error, change F$EXTRACT(l,2,COMMAND) to 
F$EXTRACT(0,2,COMMAND). Note that INQUIRE automatically converts 
input to uppercase; therefore, the quoted string in the IF statement must be 
written in uppercase for DCL to evaluate the strings as equal. 
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6.9 Handling Errors and CTRL/Y Interrupts 

The following table describes the default action taken when an error occurs 
or when you press CTRL/Y. These default actions can be overridden with the 
ON, SET [NO]ON, and SET [NO]CONTROL=Y commands. 


Interrupt 

Default Action 

Error or severe error 

CTRL/Y at DCL 
command level or 
command level 1 

CTRL/Y at command 
level lower than level 1 

Procedure exits to the next command level. 

Interrupts procedure: procedure can continue if no 
other image forces it to exit. 

Procedure exits to the next higher command level. 


6.9.1 The ON Command 

The ON command specifies an action to be performed if an error of a certain 
severity or greater severity occurs. (See Section 5.2 for discussion of error 
conditions and severity levels.) When such an error occurs, the system takes 
the following actions: 

1 The error message is displayed. 

2 The action specified by the ON command is performed. 

3 The default error action (exit to the next higher command level) is reset. 

When an error of less than the specified severity occurs, the error message 
is displayed, and the command procedure continues executing. Assume a 
command procedure executes the following command: 

$ ON ERROR THEN GOTO ERR1 

The command procedure continues to execute unless an error or severe 
error occurs. When such an error occurs, the error message is displayed; the 
default error action (exit to the next higher command level) is reset; and the 
command procedure continues execution at ERR1. If a second error occurs 
before another ON or SET NOON command is executed, the procedure exits 
to the next higher level. 

The action specified by the ON command applies only within the command 
level in which the command is executed. Therefore, if you execute an ON 
command in a procedure that calls another procedure, the ON command 
action does not apply to the nested command procedure. 

The execution of an ON statement performs an implicit SET ON function, 
thus nullifying any SET NOON condition that may be in effect. 

Note: Only one ON statement of each type can be in effect at any one time. For 
example, if the command procedure includes more than one ON ERROR 
statement, the ON ERROR statement executed most recently is in effect. 
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6.9.2 The SET [NO]ON Command 

The SET ON and SET NOON commands enable and disable error checking 
for the current command level. The SET NOON command overrides the 
ON command. If an error (regardless of severity) occurs after a SET NOON 
command is executed, the system takes the following actions: 

1 Displays the error message 

2 Continues executing the procedure 

SET NOON remains in effect until either an ON or SET ON command is 
executed. The SET ON command reenables error checking for the current 
command level. The action specified by the last ON command, if one exists, 
is reestablished. Otherwise, the default error action is reenabled. 

In the following command procedure, if an error or severe error occurs while 
copying the file, the procedure continues to execute without going to 
GET—COMMAND as specified by the ON command. 

$ ON ERROR THEN GOTO GET.COMMAND 
$GET_COMMAND: 


$ ! Type a file 

$ IF COMMAND .NES. "CO" THEN GOTO END_C0PY 
$ INQUIRE FILESPEC "File to move" 

$ INQUIRE COPYSPEC "New file specification" 
$ SET NOON 

$ COPY 'FILESPEC' 'COPYSPEC' 

$ SET ON 
$END_C0PY: 


6.9.3 CTRL/Y Interrupts 

The ON CONTROL _Y command specifies an action to be performed when 
CTRL/Y is pressed at the current command level. (By default, pressing 
CTRL/Y causes the system to prompt for command input at the CTRL/Y 
command level.) In the following command procedure, pressing CTRL/Y 
while a file is being typed passes control to the label END_TYPE. 


$ ! Type a file 

$ IF COMMAND .NES. "TY" THEN GOTO END.TYPE 
$ ON CONTROL.Y THEN GOTO END.TYPE 
$ TYPE 'FILESPEC' 

$END_TYPE: 

$ ! 

$ !Reset default 
$ SET N0C0NTR0L=Y 
$ SET C0NTR0L=Y 
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An ON CONTROL _Y command remains in effect until another ON 
CONTROL _Y or a SET NOCONTROL=Y command executes or the 
command procedure exits. 

See Section 6.11 for another example of using the ON CONTROL_Y 
command. 

To exit from a nonterminating loop when CTRL/Y is disabled, you must 
delete your process from another terminal using the DCL command STOP. 

If you disable the default CTRL/Y action, reset it as soon as possible. To 
reset the default CTRL/Y action, execute the SET NOCONTROL=Y command 
followed by the SET CONTROL=Y command, as shown in the previous 
example. 


6.10 Restarting Batch Jobs 

Chapter 3 describes how to specify that your batch job be reexecuted if the 
system crashes before the job is finished. By default, a batch job is reexecuted 
beginning with the first line. However, you can use the following symbols in 
your command procedures to specify a different restarting point: 

• $RESTART—A global symbol whose value is true if the batch job has 
been started at least once before this execution. Do not specify a value 
for $RESTART; the system will assign the appropriate value. 

• BATCH$RESTART—A global symbol whose value you specify using the 
SET RESTART_VALUE command. 

The following steps describe how to use these symbols in a command 
procedure: 

• Begin each possible starting point of the procedure with a label. 

• As the first step in each section, equate the value of BATCH$RESTART to 
the label using the SET RESTART—VALUE command. 

• At the beginning of the procedure, test $RESTART. If $RESTART is true, 
issue a GOTO statement using BATCH$RESTART as the transfer label. 

The following command procedure extracts a number of modules from a 
library, concatenates those modules, and then sorts the resulting file. If 
aborted, the command procedure reexecutes from the beginning of the file, 
the statement labeled CON C ATEN ATE —LIBRARIES or the statement labeled 
SORT-FILE, depending on the value of BATCH$RESTART. (If you were 
extracting a number of separate modules, you could make each extraction a 
separate section.) 

$ ! SORT_MODULES.COM 
$ ! 

$ ! set default to the directory containing 
$ ! the library whose modules are to be sorted 
$ SET DEFAULT WORKDISK:[ACCOUNTS.DATA83] 

$ 

$ ! check for restarting 

$ IF $ RESTART THEN GOTO BATCH$RESTART 

$ 
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$ EXTRACT.LIBRARIES: 

$ SET RESTART.VALUE=EXTRACT_LIBRARIES 


$ CONCATENATE.LIBRARIES: 

$ SET RESTART_VALUE=CONCATENATE_LIBRARIES 


$ SORT.FILE: 

$ SET RESTART_VALUE=SORT_FILE 


$ EXIT 


6.11 Cleanup Operations 

In general, execution of a command procedure should not change the user's 
process state. Therefore, a command procedure should include a set of 
commands that returns the process to its original state. Common cleanup 
operations include the following (see the lexical function descriptions in the 
DCL Commands section for lexical function specifications): 

• Closing files—If you have opened any files, make sure that they are 
closed before the command procedure exits. You can use the lexical 
function F$GETJPI to examine the remaining open file quota (FILCNT) 
for the process. If FILCNT is the same at the beginning and end of the 
command procedure, you know that no files have been left open. In the 
following example, a warning message is displayed if a file is left open: 

$ FIL.COUNT = F$GETJPI(""."FILCNT") 


$ IF FIL.COUNT .NE. F$GETJPI("","FILCNT") THEN- 
WRITE SYSSOUTPUT "WARNING — file left open" 

• Deleting temporary or extraneous files—If you have created temporary 
files, delete them. In general, if you have updated any files, you should 
purge them to delete the previous copies. Take care in deleting files 
that you have not created. For example, if you have updated a file that 
contains crucial data, you may wish to make the purging operation 
optional. 

• Resetting default device and directory—If you change the default 
device and/or directory, reset the original defaults before the command 
procedure exits. 

To save the name of the original default directory, use the DEFAULT 
keyword of the F$ENVIRONMENT lexical function. At the end of the 
command procedure, include a SET DEFAULT command that restores the 
saved device and directory. 
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The following example saves and restores device and directory defaults: 
$ SAV.DEFAULT = FSENVIRONMENT("DEFAULT") 


$ SET DEFAULT 'SAV.DEFAULT' 


The following table lists other commonly changed process characteristics as 
well as the lexical functions and commands used to save and restore the 
original settings: 


Characteristic 

To save... 

To restore... 

DCL prompt 

FSENVIRONMENT 

SET PROMPT 

Default protection 

FSENVIRONMENT 

SET PROTECTION/DEFAULT 

Privileges 

FSSETPRV 

FSSETPRV or SET PROCESS 
/PRIVILEGES 

Control characters 

FSENVIRONMENT 

SET CONTROL 

Verification 

FSVERIFY 

FSVERIFY 

Message format 

FSENVIRONMENT 

SET MESSAGE 

Key state 

FSENVIRONMENT 

SET KEY 


To ensure that cleanup operations are performed even if the command 
procedure is aborted, begin each command level in the command procedure 
with the following statement: 

$ ON CONTROL.Y THEN GOTO CLEAN_UP 

In each command level of the command procedure, place cleanup operations 
after the CLEAN _UP label. 
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By being aware of system security, you can take steps to protect your files 
from unauthorized access. This chapter discusses security features of the VMS 
operating system and describes how to protect your files and use the system 
securely. 

User Accounts 

User accounts are maintained in a file named SYS$SYSTEM:SYSUAF.DAT, 
referred to as the user authorization file, or UAF. A VMS system uses the UAF 
to validate login requests and to set up processes for users who successfully 
log in. You can examine and modify this file with the Authorize Utility 
(AUTHORIZE). 1 

The UAF contains a record for each account. Each record consists of 
fields providing information for the following areas: identification, login 
characteristics, login restrictions, priority, limits, and privileges. The user 
name field is specified as a parameter to Authorize Utility commands; the 
other fields are specified as qualifier values of Authorize Utility commands. 
See the VMS Authorize Utility Manual for descriptions of the qualifiers and 
information about invoking the Authorize Utility. 

Protection 

The VMS operating system provides two related mechanisms to control the 
access that users have to system objects as follows: 

• UlC-based protection—Each user process in the system is assigned 
a user identification code (UIC) in the user authorization file (UAF) 
with the Authorize Utility. Each object on the system, such as a file, is 
also assigned a UIC (typically the UIC of its creator). Each object also 
maintains a protection mask, a structure which defines the type of access 
allowed to users, based upon the relationship between the user UIC and 
the object UIC. 

• ACL-based protection—An access control list (ACL) that specifies the type 
of access to be granted or denied to a particular user or group of users 
may be associated with a system object. An ACL is an optional form of 
protection that is typically created by the object owner using the ACL 
editor (invoked with the DCL command EDIT/ACL) or the SET ACL 
command. 

The system objects for which ACL-based protection can be specified are: 
files, directories, devices, batch and print queues, logical name tables, and 
global sections. Users are specified by identifiers in the rights database 
that are assigned with the Authorize Utility. (The rights database is 
described in Section 7.2.2.2.) 
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The system determines whether to grant a user access to an object, as follows: 

1 ACL—If the user matches an identifier in the object's ACL, the system 
grants or denies access based on the ACL. However, even if an entry 
in the ACL denies access, the system may still grant access based 

on the SYSTEM and OWNER fields of the UlC-based protection (see 
Section 7.2.1.2). 

2 UIC—If the user does not match an identifier in the object's ACL or 
the object has no ACL, the system grants or denies access based on the 
relationship between the user's UIC and the object s UIC as specified in 
the object's protection mask. 

3 Privileges—If the system denies the user access, the user may be granted 
access by using one of the following privileges: BYPASS, GRPPRV, 
READALL, or SYSPRV. 

UlC-based protection is useful for denying or granting access to a specified 
group of users or to all users on the system. The optional ACL-based 
protection allows further control over the protection of an object. You can 
grant or deny access to individual users, and you can further identify users 
by certain aspects of their usage (such as whether they are interactive, batch, 
local, remote, or dialup users). The combination of UIC and ACL protection 
provides a way to specify multiple subsets and overlapping groups of users. 


7.2.1 UlC-Based Protection 

Typically, you use UlC-based protection if the object is to be accessed by: 

(1) only the owner, (2) all users on the system, or (3) a specific group of users. 


7.2.1.1 UIC Format 

UICs are a subset of the identifiers that the VMS system uses to identify users 
and groups of users (see Section 7.2.2.2 for other identifiers). Each user on 
the system is assigned a unique UIC when the account is created. A UIC 
consists of two parts, group and member, specified in the following format: 

[group.member] 

A UIC can be either numeric or alphanumeric. 

• Numeric UIC—Consists of a group number in the range 0 through 37776 
(octal) and a member number in the range 0 through 177776 (octal). 

• Alphanumeric UIC—Consists of a member name (the user name 
parameter specified with the Authorize Utility command ADD) and, 
optionally, a group name. The UIC group name is taken from the account 
name specified with the /ACCOUNT qualifier. Member and group names 
must contain at least one alphabetic character and up to a maximum of 31 
alphanumeric characters (including A through Z, 0 through 9, underscore, 
and dollar sign characters). An alphanumeric UIC is equated to a numeric 
UIC in the rights database by default once the rights database has been 
created. You can generally specify a numeric UIC and its equivalent 
alphanumeric UIC interchangeably. 
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The member component of a UIC must be unique to the system. By default, 
the member component of an alphanumeric UIC is equated to both the group 
and member components of a numeric UIC in the rights database (so that 
specifying just the member part of an alphanumeric UIC is sufficient). The 
following examples illustrate several UICs in proper UIC notation: 


UIC 

Meaning 

[200,10] 

Group 200, member 10 

[3777,3777] 

Group 3777, member 3777 

[USER.FRED] 

Group USER, member FRED 

[EXEC.JONES] 

Group EXEC, member JONES 

[JONES] 

Group EXEC, member JONES 


When you log in to a VMS system, the UIC of your process is the UIC 
specified in your UAF account. Typically, your process UIC does not 
change, although it can be changed with the SET UIC command (which 
requires CMKRNL privilege). By default, detached processes (created by 
the DCL command SUBMIT or RUN) and subprocesses (created by the 
DCL command SPAWN) take the same UICs as their creators. If you have 
DETACH privilege, you can create a detached process with a different UIC 
(by using the /UIC qualifier of the RUN command). 

By default, an object (such as a file) receives the UIC of the process creating 
it. You can change the UIC of a file with the /OWNER_UIC qualifier of 
the BACKUP, CREATE, SET DIRECTORY, and SET FILE commands. With 
SYSPRV privilege, you can specify any UIC; with GRPPRV privilege, you can 
specify any member within your current group; otherwise, you can specify 
only your own UIC. 

You can specify the UIC of a disk volume with the /OWNER_UIC qualifier 
of the INITIALIZE and MOUNT commands (except for the system disk, 
which retains the UIC specified when it was initialized). You can also 
change the UIC of a disk (including the system disk) with the SET VOLUME 
command. You must have the VOLPRO privilege to specify a UIC other 
than your own. In addition, when you initialize a system disk (/SYSTEM 
qualifier), it receives a UIC of [1,1] and a group disk (/GROUP qualifier) 
receives a UIC of [n,0], where n is the group number of the owner. You can 
specify a UIC for a device such as a terminal (by default, devices are not 
owned) with the /OWNER_UIC qualifier of the SET PROTECTION/DE VICE 
command. 


7.2.1.2 Ownership and Access Categories 

The relationships between the UIC of a process and the UIC of an object fall 

into the following four ownership categories: 

• System—The UIC of the process is in the range 1 through 10 (octal) 
or the process has SYSPRV privilege. (The range of system UICs is 
determined by the SYSGEN parameter MAXSYSGROUP, which defaults 
to 10 octal.) 

• Owner—The UIC of the process and the UIC of the object are identical. 

• Group—The group number of the process and the group number of the 
object are identical or the process has GRPPRV privilege. 
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• World—All users on the system. 

A process may be able to access an object through more than one of these 
ownership categories. For example, a user with a UIC of [CS102,MARTIN] 
can attempt access to an object with a UIC of [CS102,PROF] through both the 
group and world categories. 

A process can access an object in the following ways: 

• Read (allocate)— Read a file; read from a disk volume; allocate nonfile 
devices. 

• Write—Write a file; write to a disk volume. 

• Execute (create)—Execute an image file; look up entries in a directory if 
you explicitly specify the file name (without using wildcard characters); 
create files on a disk volume. 

• Delete—Delete files. 


7.2.1.3 Protection Masks 

A protection mask is a structure created by the system for each system object 
defining the type of UIC access allowed to the object. A protection mask 
consists of four fields, each with four indicators. Each field applies to one 
category of ownership. Each indicator within a field applies to one category 
of access. The fields and indicators are as follows: 


Ownership Fields Access Indicators 


SYSTEM 

READ 

WRITE 

EXECUTE 

DELETE 

OWNER 

READ 

WRITE 

EXECUTE 

DELETE 

GROUP 

READ 

WRITE 

EXECUTE 

DELETE 

WORLD 

READ 

WRITE 

EXECUTE 

DELETE 


Protection for an object must be specified in the following format: 

(ownership[:access],...) 

Specify ownership as one of the following (each may be abbreviated to one 
character): SYSTEM, OWNER, GROUP, or WORLD. Specify access as one or 
more of the following indicators: R (read), W (write), E (execute), D (delete). 
Omission of the colon and access indicators disallows access for that category 
of ownership. The following protection specification allows system users full 
access to an object, the owner full access except delete, and group and world 
users no access: 

(S:RWED,0:RWE,G,W) 

Omission of an ownership category generally results in no access being 
granted to that category. However, the SET PROTECTION command retains 
the existing protection of the object for omitted fields of the ownership 
category. 
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7.2.1.4 Securing User Data and Devices 

The suggestions for establishing UlC-based protection of data and devices 

belonging to individual and application accounts are as follows: 

• Default protection—Make sure your default protection is adequate. In 
general, you do not want to grant write or delete access to world users. 
You may or may not want to grant write access to group users. You may 
or may not want to grant read access to world users. 

By default, the system assigns each file the following protection mask: 

(S:RWED.0:RWED,G:RE.W) 

You can redefine this default for all files you create using the SET 
PROTECTION/DEFAULT command, or you can modify the protection 
on individual files using the /PROTECTION qualifier to the SET FILE 
command. 

• Sensitive files—Protect sensitive files by specifying extra protection, for 
example, with the SET PROTECTION command. You can also protect 
sensitive files by maintaining them in a subdirectory on which extra 
protection is set. However, to protect sensitive files completely, directory 
protection alone is not adequate. You must also protect each individual 
file contained within the directory. You can add a default protection ACE 
to the subdirectory file that defines the UIC protection mask for newly 
created files in the directories (see Section 7.2.2.5). 

• Individual access—Use access control lists (ACLs) to grant or deny 
individual users access to a file (see Section 7.2.2). 

• Copied files—In general, do not copy a file into someone else's directory 
(for example, if you have write access to a group member's directory), as 
it will have your UIC instead of the UIC of the directory's owner. Use 
the MAIL command to send the file, or have the owner of the directory 
copy the file. 

• Private volumes—A private volume is one that is mounted on a device 
allocated to your process. No other users on the system can access 
the volume. If you mount a private volume, use the DEALLOCATE 
command to deallocate the device when you are done. 


7.2.2 ACL-Based Protection 

Typically, you use access control lists (ACLs) on system objects to grant 
or deny access to individual users, groups of users, and to subsets of user 
groups. ACLs contain entries (ACEs) that specify the access to be granted or 
denied a user or group of users. The user or group of users is designated by 
identifiers, as described in Section 7.2.2.2. 
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7.2.2.1 Object Types 

You can establish ACLs for various system objects: files, directory files, 
devices, global sections, queues, and logical name tables. In general, you 
need not be concerned about the object type when establishing or changing 
an ACL; however, ACLs set up on devices, logical name tables, and global 
sections (except those backed by files) are not saved and must be reestablished 
every time the system is booted. 

ACLs on system objects are set up and modified with the ACL editor (see 
Section 7.3.2) or with the DCL command SET ACL in the following format: 

SET ACL/OBJECT_TYPE=object-type object-name . . . 

For example, the following command adds an ACL to the file 
PERSONNEL.DAT containing a single ACE that denies all network access 
to the file: 

$ SET ACL/OBJECT_TYPE=FILE PERSONNEL.DAT - 
_$ /ACL=(IDENTIFIER=NETWORK,ACCESS=NONE) 


7.2.2.2 Identifiers 

An identifier is a value that represents an individual user, or a group of users, 
for an aspect of the user's environment. Following are the three types of 
identifiers: 

• UIC identifiers 

• General identifiers 

• System-defined identifiers 

A UIC identifier is created each time a new user account is added with the 
Authorize Utility. The UIC identifier matches the UIC specified for the user. 

A second UIC identifier is created matching the name of the UIC group 
when a UIC group is defined for the first time. UICs can be in both numeric 
and alphanumeric form (see Section 7.2.1.1) and are useful in identifying 
individual users in ACLs. UIC identifiers must be enclosed in brackets 
and can have wildcard characters in either the group or member fields (for 
example, [EXEC,*]). 

Identifiers include other general identifiers that you explicitly associate with 
users in the rights database. These general identifiers are useful in identifying 
multiple groups of users outside the bounds of UIC groups. For example, you 
could create the identifier SECRET and assign it in the rights database to a 
selected group of users, some of whom could be in different UIC groups. 

A third type of identifier includes the following system-defined identifiers, 
which you can use to identify users by their mode of using the system: 
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System*Defined Identifiers 

Type of User 

BATCH 

Batch user 

DIALUP 

User logged in on a dialup terminal 

INTERACTIVE 

Interactive user 

LOCAL 

User logged in on local terminal 

NETWORK 

Network process 

REMOTE 

User logged in over the network 


Generally, you should treat the preceding system-defined identifiers as being 
mutually exclusive. However, you can combine them with UIC identifiers 
or general identifiers by connecting them with plus signs (for example, 
[FREDJ+BATCH). Access is granted only if both identifiers are true. (In the 
example [FREDJ+BATCH, the user identified as [FRED] must be running a 
batch job for the system to grant the specified access.) 

Following are examples of user-defined identifiers that are valid for ACL- 
based protection: 

• PAYROLL—Specifies all users holding the identifier PAYROLL. 

• [USERJONES]—Specifies the user whose alphanumeric UIC is group 
USER and member JONES. 

• [200,10]—Specifies the user whose numeric UIC is group 200, member 

10 . 

• [FREDJ+BATCH—Specifies the batch user whose alphanumeric UIC is 
FRED. 

• DIALUP—Specifies all users logged in on a dialup terminal. 

Rights List 

The system determines protection by checking identifiers in the object's ACL 
against the list of identifiers held by the accessor to find a matching entry. 
The list of identifiers held by the accessor is called a rights list. 

The file containing all the identifiers defined in the system is called the 
rights database. (Identifiers are defined and granted to specific users with 
the AUTHORIZE commands ADD/IDENTIFIER and GRANT/IDENTIFIER.) 
The rights list, created for each process at login, is the portion of the rights 
database containing all the identifiers and attributes held by the user. 


7.2.2.3 Access Control List Entries (ACE) 

An entry in an access control list specifies the access to a system object that 
is to be granted or denied a user. This access is specified by the identifier. 
Different kinds of access are: NONE, READ, WRITE, EXECUTE, DELETE, 
and/or CONTROL. 

Following are the three types of ACEs: 

• Identifier ACE 

• Default—protection ACE 

• Alarm-journal ACE 
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7.2.2.4 IDENTIFIER ACEs 

An identifier ACE controls the type of access allowed to a particular user or 
group of users. Identifier ACEs have the following format: 

(IDENTIFIER=identifier[,0PTI0NS=options+...],ACCESS=access+...) 

The following are examples of ACEs: 

(IDENTIFIER 3 [200.201],ACCESS=READ+WRITE+EXECUTE) 

Grants the user identified by UIC identifier [200,201] read, write, and execute 
access to the system object. 

(IDENTIFIER 3 [FRED]+BATCH,ACCESS=WRITE+EXECUTE) 

Grants batch user with the alphanumeric UIC [FRED] write and execute access 
to the system object. 

(IDENTIFIER=PAYR0LL,ACCESS=READ) 

Grants users who hold the identifier PAYROLL read access to the system 
object. 

(IDENTIFIER=DIALUP,ACCESS=N0NE) 

Denies holders of the system-defined identifier DIALUP any access to the 
system object. 

The preceding ACEs could be specified in a single ACL for a system object as 
follows: 

(IDENTIFIER 3 [200,201].ACCESS=READ+WRITE+EXECUTE) 

(IDENTIFIER 3 [FRED]+BATCH,ACCESS=WRITE+EXECUTE) 

(IDENTIFIER=PAYR0LL.ACCESS=READ) 

(IDENTIFIER=DIALUP.ACCESS=N0NE) 

To specify one or more default ACEs for inclusion in the ACLs of files 
subsequently created in a directory, use the OPTIONS=DEFAULT option 
of an identifier ACE. The following ACE, when placed in the ACL of the 
directory file, grants all users holding the SECRET identifier read, write, and 
execute access to new files in the directory: 

(IDENTIFIER=SECRET,0PTI0NS=DEFAULT.ACCESS=READ+WRITE+EXECUTE) 

Note: Default protection is associated only with newly created files, not existing 
ones. If you add a default protection ACE to a directory, you must also 
change the protection on files already in the directory. 

Because the system determines access at the first matching entry, the order of 
the entries is critical. For example, if the last entry in the previous example— 
(IDENTIFIER=DIALUP,ACCESS=NONE)—were placed at the top of the list, 
all dialup users (including those specified in the remaining entries) would be 
denied access to the associated file. Placing it last in the access control list 
allows users holding identifiers [200,201], [FREDJ+BATCH, and [PAYROLL] 
the specified access, even when they are dialup users. 
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7.2.2.5 DEFAULT-PROTECTION ACEs 

To specify default protection for new files in a particular directory, place 
a default-protection ACE in the ACL of the directory file. (The directory 
file is the file with the directory name as file name and DIR as file type 
in the parent directory). The default-protection ACE affects files that are 
subsequently created in the directory and in any subdirectories under that 
directory unless protection is specified for one of those files individually. 
Default—protection ACEs apply UlC-based protection. Specify a 
default—protection ACE in the following format, where protection-mask is the 
same mask used in UIC protection (see Section 7.2.1.3): 

(DEFAULT_PROTECTION[.options].protection-mask) 

The following default—protection ACE specifies that by default the system 
and owner have read, write, execute, and delete access to any files 
subsequently created for the directory and that group and world users have 
no access. 

(DEFAULT.PROTECTION,S:RWED.0:RWED,G.W) 


7.2.2 6 ALARM-JOURNAL ACEs 

The alarm—journal ACE allows you to specify that an alarm message be 
sent to the security operator's terminal if a certain type of access takes place. 
Alarms are supported only for files and global sections. The alarm-journal 
ACE functions only when alarms to the security operator's terminal have 
been enabled through the DCL command SET AUDIT, security messages to 
the operator's terminal have been enabled with the DCL command 
REPLY/ENABLE=SECURITY, and the OPCOM process is executing. 

Following is the format of an alarm—journal ACE: 

(ALARM.JOURNAL=SECURITY[,options+...][,access+...]) 

The following alarm—journal ACE specifies that an alarm will be sent to the 
security operator's terminal if an accessor attempts to read the object, and that 
this ACE will be preserved even when an attempt is made to delete the entire 
ACL: 

(ALARM.JOURNAL=SECURITY,OPTIONS=PROTECTED,ACCESS=READ+SUCCESS+FAILURE) 

For an alarm to have any effect, you must include either SUCCESS or 
FAILURE or both in the ACCESS field. 


7.2.3 File Protection 

File protection is usually transparent. To set protection or modify the ACL of 
a file, you must own the file, have control access to the file, or have GRPPRV, 
SYSPRV, BYPASS, or READALL privilege. 

Note: To completely protect a file, you must apply the same or greater 

protection to the directory in which the file resides. See Section 7.2.3.3 for 
information on directory protection. 
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7.2.3.1 Default File Protection 

A new file receives default UlC-based protection and the default ACEs (if 
any) of its parent directory. A renamed file's protection is unchanged. A 
new version of an existing file receives the UlC-based protection and ACL 
of the previous version. (Use the /PROTECTION qualifier of the BACKUP, 
COPY, CREATE, and SET FILE commands to override the default UlC-based 
protection.) 

You can use either of the following methods to override the default UIC- 
based protection given to new files: 

• Default UIC protection—The operating system provides each process 
with a default UlC-based protection of (S:RWED,0:RWED,G:RE,W). This 
indicates that SYSTEM users and the owners of objects have full access 
to the object, users in the same UIC group as the object owner have 
read and execute access to the object, and all other users are denied 
access to the object. To change the default protection, invoke the SET 
PROTECTION command with the /DEFAULT qualifier. For example, if 
you place the following command in your login command procedure, you 
grant all processes read and execute access to any files that you create. 
(Remember that you must execute the login command procedure for this 
command to execute.) 

$ SET PROTECTION = (S:RWED,0:RWED,G:RE.W:RE)/DEFAULT 

• Default ACL protection—You can override default UIC protection for 
specified directories or subdirectories by placing a default—protection 
ACE in the ACL of the appropriate directory file. The default protection 
specified in the ACE is applied to any new file created in the specified 
directory or subdirectory of the directory. The following ACE, which 
must be in the ACL of a directory file, specifies that the default protection 
for that directory and the directory's subdirectories allow system and 
owner processes full access, group processes read and execute access, and 
world users no access. 

(DEFAULT.PROTECTION.S:RWED.0:RWED,G:RE.W:) 

To specify a default identifier ACE to be copied to the ACL of any file 
subsequently created in the directory, specify the DEFAULT option in the 
directory file's identifier ACL. 


7.2.3.2 Explicit File Protection 

You can explicitly specify UlC-based protection for a new file with the 
/PROTECTION qualifier (valid with the BACKUP, COPY, and CREATE 
commands) as shown in the following example: 

$ CREATE MAST12.TXT/PR0TECTI0N=(S:RWED.0:RWED.G.W) 

You can change the UlC-based protection on an existing file with the SET 
PROTECTION command as shown in the following example: 

$ SET PR0TECTI0N=(S:RWED,0:RWED.G.W) MAST12.TXT 

After a file is created and you have created an ACL for the file, you can 
modify the ACL and add as many ACEs to the ACL as you want. The 
protection specified by the ACL overrides the file's UIC protection. 
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7.2.3.3 Directory Protection 

You cannot completely protect a file without applying at least the same 
protection to the directory in which the file resides. For example, if you 
deny a user all access to a file but allow that user read access to the file's 
directory, the user cannot access the contents of the file but can see that it 
exists. Conversely, a user allowed access to a file and denied access to the 
file's directory (or one of the parent directories) cannot see that the file exists. 

Note: To protect sensitive files, directory protection alone is not adequate. You 
must also protect each file within the directory. 

By default, top level directories receive UlC-based protection 
(S:RWE,0:RWE,G:RE,W:E) and no ACL. Subdirectories receive UlC-based 
protection from the parent directory. 

To specify UlC-based protection explicitly when creating a directory, use 
the /PROTECTION qualifier of the CREATE/DIRECTORY command. You 
cannot specify an ACL for the directory until the directory is created. To 
change the UlC-based protection of an existing directory, use the SET 
PROTECTION command (apply this command to the directory file). To 
specify or change the ACL of an existing directory, edit the directory file's 
ACL (see Section 7.2.3.1). 

You can limit but not prohibit directory access by specifying execute access 
but not read access. Execute access on a directory permits you to examine 
and read files that you know are contained in the directory (that is, you know 
the file specifications), but prevents you from displaying a list of the files in 
the directory. 


7.2.3.4 Mail File Protection 

Mail files receive the protection (S:RWD,0:RW,G,W). Files of type MAI 
created with the EXTRACT command of the Mail Utility receive the protection 
(S:RWD,0:RWD,G,W). 


7.2.4 



Disk Volume Protection 

By default, no protection is applied to newly initialized disk volumes. You 
can specify protection with the /PROTECTION qualifier of the INITIALIZE 
command and you can specify an ACL for a disk volume. The following 
example specifies UlC-based protection for the disk volume ACCOUNT1: 

$ INITIALIZE WORKDISK: ACC0UNT1 - 
_$ /PR0TECTI0N=(S:RWED,0:RWED,G:R,W:R) 

You can respecify the protection each time you mount the volume with the 
/PROTECTION qualifier of the MOUNT command. You must own the 
volume or have VOLPRO privilege to change protection. 

You can also limit access to a disk volume with the following qualifiers to the 
INITIALIZE and MOUNT commands: 

• /SYSTEM—All processes have RWED access to the volume, but only 
system processes (or processes with SYSNAM and SYSPRV privileges) 
can create first-level directories. (The volume is owned by [1,1].) 

• /GROUP and /NOSHARE—System, owner, and group processes have 
RWED access to the volume. World users have no access. 
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• /NOSHARE—System and owner processes have RWED access to the 

volume. Group and world users have no access. 

At initialization time, the preceding qualifiers override any protection mask 
specified. At mount time, however, the protection mask overrides the 
qualifiers. When mounting a volume, you must have GRPNAM privilege 
to specify /GROUP, and SYSNAM privilege to specify /SYSTEM. 


7.2.5 Device Protection 

In general, device protection controls the ability to allocate the device and 
is specified by granting read access in an ACL. To specify an ACL for a disk 
device, use the SET ACL/OBJECT_TYPE=DEVICE command. For example, to 
grant a user with the alphanumeric UIC [FRED] read access to the disk device 
WORKDISK, type: 

$ SET ACL/OBJECT_TYPE=DEVICE/ACL=(IDENTIFIER=[FRED],ACCESS=READ) - 
_$ WORKDISK 

Note that when you specify an ACL for a disk device, the ACL :s associated 
with the device, not with the disk volume. For example, when you mount a 
disk volume, specify an ACL for the device. Then when you dismount the 
volume, the ACL protection remains on the device. 

The only protection that applies to a nonfile device is the ability to allocate 
it, specified by read access. By default, nonfile devices such as mailboxes are 
unprotected. Interactive terminals are set up to provide complete access to 
system users and no access to all other users. (Note that access here refers to 
access via an application program. The device protection on a terminal does 
not control who can log in to it.) 

You can change the protection of a nonfile device through the use of ACLs 
or by changing the standard UIC protection. Modify the ACL with the DCL 
command SET ACL/OBJECT_TYPE=DEVICE. Modify the UIC protection 
with the DCL command SET PROTECTION/DEVICE (requires OPER 
privilege). For example, the following command allows users holding the 
PAYROLL identifier read access to TERMINAL3: 

$ SET ACL/OBJECT_TYPE=DEVICE/ACL=(IDENTIFIER=PAYROLL,ACCESS=READ) - 
_$ TERMINAL3 


7.2.6 Displays of Ownership and Protection 

You can display ownership and protection information with the following 
commands and qualifiers: 


Command Display 


DIRECTORY/ACL file-spec 
DIRECTORY/OWNER—UIC file-spec 
DIRECTORY/PROTECTION file-spec 
DIRECTORY/SECURITY 
DIRECTORY/FULL file-spec 


File's ACL 
File's UIC 

File's UlC-based protection 
All of the above 
All of the above 
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Command 

Display 

SHOW ACL 

Device, file, batch or print queue. 


logical name table, or global 


section's ACL 

SHOW PROCESS/ALL 

Process UIC 

SHOW PROTECTION 

Default file protection 

SHOW DEVICES/FULL device-name 

Device UIC and protection 


7.3 Creating and Deleting ACLs 

Use the ACL editor (invoked with the DCL command EDIT/ACL) to create 
an ACL or to make major changes to it. Use the DCL command SET ACL 
with the /OBJECT-TYPE qualifier to make minor changes to an ACL or to set 
an ACL on more than one object. 


7.3.1 Using the SET ACL Command 

The DCL command SET ACL allows you to specify an ACL for a file, 
directory, device, batch or print queue, system logical name table, or global 
section. The /OBJECT-TYPE qualifier is required for all objects except files. 
To specify an ACL for a device, for example, specify the SET ACL command 
with the /OBJECT_TYPE=DEVICE qualifier. The following command 
specifies an ACL that grants users who hold the identifier PAYROLL read 
access to the disk device WORKDISK: 

$ SET ACL/OBJECT_TYPE=DEVICE/ACL=(IDENTIFIER=PAYROLL,ACCESS=READ) - 
_$ WORKDISK 

To set the same ACL on all files with the file type DAT in the default 
directory, enter the following: 

$ SET ACL/OBJECT_TYPE=FILE/ACL=(IDENTIFIER=PAYROLL,ACCESS=READ) - 
_$ *.DAT;* 

To select a subset of the files specified by the wildcard character, use one or 
more of the following qualifiers: 


Qualifier Meaning 


/BY_OWNER 

/EXCLUDE 

/BEFORE 

/SINCE 

/CREATED 


Selects files with a specified UIC 

Selects all but the specified files 

Selects files created or modified before a specified time 

Selects files created or modified since a specified time 

Specifies that /BEFORE or /SINCE check for the creation date 


You can also use the /CONFIRM qualifier with the preceding qualifiers to 
elicit a confirmation prompt for each file; the /CONFIRM qualifier allows you 
to specify whether the file is to be excluded. 
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7.3 Creating and Deleting ACLs 


By default, the DCL commands that create ACLs add the entries to the top 
of the ACL in the order specified. (If the object does not have an ACL, an 
ACL is created.) Use the /AFTER qualifier to specify a position for the entry 
(other than the top of the ACL). For example, the following command places 
a new entry after an existing entry—the ACE specified with the /AFTER 
qualifier—in the access control list of the file DOGS83.DAT: 

$ SET ACL/AFTER=(IDENTIFIER®[JONES],ACCESS=READ)- 
_$ /ACL=(IDENTIFIER=SECRET,ACCESS=READ+EXECUTE) D0GS83.DAT 

The /AFTER qualifier is especially useful because the ACEs are processed 
from first to last. For example, if users holding the identifier PAYROLL are 
denied access in an ACE that precedes one granting access to user FRED, and 
if FRED holds both identifiers, FRED will be denied access. 

The SET ACL command also permits the following ACL operations: 

• Delete an ACE—Use the /DELETE qualifier to delete ACEs (specified on 
the /ACL qualifier) from an object's ACL. If no value is specified with 
the /ACL qualifier, all the entries in the ACL of the specified objects are 
deleted (except those entries protected by the PROTECTED option). The 
following example deletes the ACE specified with the /ACL qualifier from 
the ACL of the latest version of each file with type FOR in the default 
directory: 

$ SET ACL/OBJECT_TYPE=FILE - 

_$ /ACL=(IDENTIFIER=PAYROLL.ACCESS=READ+WRITE+EXECUTE)- 
_$ /DELETE *.FOR 

• Replace an ACE—Use the /REPLACE qualifier to specify an ACE to 
replace the ACE specified by the /ACL qualifier. If no value is specified 
with the /ACL qualifier, the ACEs specified by the /REPLACE qualifier 
are added to the ACLs of the specified objects. The following example 
changes the ACE specified with /ACL to the one specified by /REPLACE 
in the ACL of the device WORKDISK: 

$ SET ACL/ACL=(IDENTIFIER=[200,200],ACCESS=READ)- 
_$ /REPLACE 3 (IDENTIFIER=NONEXEC.ACCESS=N0NE)- 
_$ /OBJECT_TYPE=DEVICE WORKDISK 

• Copy an ACL—Use the /LIKE qualifier to copy an ACL from one object 
to another. Specify the name of the object whose ACL is to be copied 
as the value of the /LIKE qualifier and specify the name of the objects 
to receive the ACL as the parameter of the SET ACL command. The 
following example copies the ACL from [USERjX.X to all versions of all 
files in the [USER] directory tree. The /LOG qualifier displays each file 
specification as the file is modified. (You might also want to include the 
/CONFIRM qualifier, which issues a request for confirmation before each 
modification.) 

$ SET ACL/LOG/LIKE 3 [USER.TESTS]X.X [USER 

• Propagate the directory ACL—Use the /DEFAULT qualifier to copy the 
ACL on a directory file to files in the directory. For subdirectory (DIR) 
files in the directory, all ACEs except those with the NOPROP AGATE 
option are copied. For all other files, only ACEs with the DEFAULT 
option are copied from the parent directory. Any ACL that already exists 
on the file is deleted. 


7-14 










Maintaining Accounts and System Security 
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Use wildcards to copy the directory ACL to multiple files or to copy the 
directory ACL throughout the directory tree. The following example 
propagates the ACL on the [JMARTIN.WORK] directory to all files in the 
subdirectory: 

$ SET ACL/DEFAULT [JMARTIN.WORK]*.*;* 


7.3.2 ACL Editor 

It is often more convenient to use the ACL editor instead of the SET ACL 
command (for example, when creating or modifying long ACLs). To invoke 
the ACL editor, type EDIT/ACL followed by the name of the object whose 
ACL you want to edit and press the RETURN key as follows: 

$ EDIT/ACL PR0TA.TXT 

If the object has an ACL, the ACL appears on the screen. Otherwise, you 
are creating an ACL and will begin the editing session by entering an ACE. 
Enter ACL editor commands using the keypad keys shown in the following 
diagram. 


PF1 

PF2 

PF3 

PF4 

GOLD 

HELP 

FNDNXT 

DEL ACE 


HELPFMT 

FIND 

UND ACE 

7 

SEL FIELD 

8 

9 

DEL W 

ADV FIELD 



UND W 

4 

ADVANCE 

5 

BACKUP 

6 

y 

DEL C 

BOTTOM 

TOP 


UND C 

1 

WORD 

2 

EOL 

3 

ENTER 


DEL EOL 


ENTER 

0 


• 

OVER ACE 



INSERT 

ITEM 



ZK-1740-84 


By default, the ACL editor operates as if the object whose ACL is being 
edited is a file. To specify an object other than a file, use the /OBJECT-TYPE 
qualifier. For example, to edit the ACL of a device named TTA1, enter the 
following command line: 

$ EDIT/ACL/OBJECT_TYPE=DEVICE TTA1: 
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7.3 Creating and Deleting ACLs 


7.3.2.1 


You can specify any one of the following objects with the /OBJECT-TYPE 
qualifier: 

PILE Specifies that the object type is a file or a 

directory file 


DEVICE 

SYSTEM —GLOBAL -SECTION 
GROUP-GLOBAL-SECTION 


Specifies that the object type is a device 
Specifies that the object type is a system global 
section 

Specifies that the object type is a group global 
section 


LOGICAL-NAME-TABLE 
QUEUE 


Specifies that the object type is a logical name 
table 

Specifies that the object type is a queue 


To execute a command, press the key. To execute the lower command shown 
on a key in the diagram, press the GOLD key first, and then press the key. 
You can display information on each command by pressing the HELP key 
followed by the command. To display information on the proper format of 
an ACE, press GOLD and then HELP. 

To exit from the editor and create or modify the ACL, press CTRL/Z. To 
exit without creating or modifying the ACL, press GOLD and CTRL/Z. To 
refresh the screen while in the editor (for example, after receiving a broadcast 
message), enter CTRL/W. 

The ACL editor edits a copy of the ACL. If your ACL editing session is 
terminated by entering CTRL/Y or if the system fails, the existing ACL 
remains unchanged or, if no ACL exists, no ACL is created. To recover an 
ACL editing session interrupted by CTRL/Y or system failure, specify the 
/RECOVER qualifier of the EDIT/ACL command. 


Using Prompts 

By default, the ACL editor prompts for each ACE and provides values 
in the various fields within an ACE whenever possible. The /MODE 
qualifier controls the choice of mode. To disable prompting, specify 
/MODE=NOPROMPT. 

The FIELD, ITEM, and ENTER commands on the keypad enable you to take 
full advantage of prompt mode in the ACL editor. 

• FIELD—Completes the current ACE field and moves the cursor to the 
next ACE field or subfield, inserting text as needed. If the ACL editor 
is not in prompt mode, the ACL editor advances to the next field in the 
current existing ACE. 

• ITEM—Selects the next item for the current ACE field. If the ACL editor 
is not in prompt mode, this key is ignored. 

• ENTER—Indicates that the current ACE is complete. This key ends the 
insertion. You can press it while the cursor is located at any position 
within the ACE. (Pressing the RETURN key produces the same results.) 


7-16 











Maintaining Accounts and System Security 

7.3 Creating and Deleting ACLs 


7.3.2.2 Moving the Cursor 


To position the cursor within the current line, use the following commands: 

Command 

Action 

EOL 

WORD 

ADVANCE 

BACKUP 

LEFT ARROW 

RIGHT ARROW 

FIELD 

ITEM 

Moves the cursor to the end of the line 

Moves the cursor one word in the current direction 

Sets the cursor direction to forward 

Sets the cursor direction to backward 

Moves the cursor left one character 

Moves the cursor right one character 

Completes the current ACE field and moves the cursor to the 
next ACE field or subfield 

Selects the next item for the current ACE field 

The following commands move the cursor to a different line of the ACL: 

Command 

Action 

BOTTOM 

TOP 

UP ARROW 

DOWN ARROW 

OVER ACE 

Moves the cursor to the end of the ACL 

Moves the cursor to the beginning of the ACL 

Moves the cursor up a line 

Moves the cursor down a line 

Moves the cursor to the next ACE 


To locate a specified text string or locate the next occurrence of a previously 
specified text string, use FIND and FIND NEXT. 

If the command moves the cursor out of an unprocessed ACE, the editor 
attempts to process the current ACE. If the ACE is improperly formatted, an 
error occurs and the cursor remains in place. 


7.3.2.3 Entering and Deleting Data 

Unless you disable prompting, the following text appears on the screen when 
you invoke the ACL editor: 

(IDENTIFIED 

If you want to create an identifier ACE, specify the identifier value by typing 
in the appropriate value. You can also delete the text and type a 
default-protection or alarm—journal ACE. 
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7.3 Creating and Deleting ACLs 


To delete text, use the following commands: 

Command 

Action 

DEL C 

Deletes the current character 

DELETE key 

Deletes the previous character 

DEL W 

Deletes the current word 

LINE FEED 

Deletes the previous word 

DEL EOL 

Deletes from cursor to end of line 

DEL ACE 

Deletes the current ACE 

CTRL/U 

Deletes the text from the cursor to the beginning of the line 


If you delete text by mistake, you can restore it by using the following 
commands: 


Command 

Action 

UND C 

UND W 

UND ACE 

GOLD CTRL/U 

Restores the most recently deleted character 

Restores the most recently deleted word 

Restores the most recently deleted ACE 

Restores the most recently deleted portion of a line 


7.3.2.4 Processing an ACE 

To process an ACE, press ENTER or carriage return. You must process the 
current ACE before you can begin editing a second ACE. If the ACE is in the 
proper format, the editor puts the ACE into the ACL and moves the cursor 
to the next line. If the cursor is positioned at the end of the ACL and if 
prompting is enabled, the editor displays the text IDENTIFIER^ (Moving 
the cursor off a line containing an unprocessed ACE implicitly processes the 
ACE.) 
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Editing Files with the EVE and EDT Editors 



8.1 



Text editors are computer programs that allow you to enter text from a 
keyboard into computer memory. Once the text is in memory, you can 
modify the text using text editing commands. For example, you can type 
in data for a report and then rearrange sections, duplicate information, or 
substitute phrases. Text editors also format text so that the report or article 
can be ready for distribution. Different formatting commands set margins, 
insert white space, and paste in figures and tables. 

VMS supports several text editors. This chapter discusses the EVE and the 
EDT editors. 

The EVE Editor " ” 

EVE, the Extensible VAX Editor, is an editor built on the VAX Text Processing 
Utility (VAXTPU), a high performance, programmable, text processing utility. 
Using EVE, you can create and edit new files or edit existing files. You can 
add text to a file and modify or format that text. EVE is interactive, so you 
see the changes to a file as you make them. 

Unlike the EDT editor, EVE lets you display more than one buffer on the 
screen at a time and to edit more than one file during the same editing 
session. EVE is easy to customize or extend using EVE commands and 
VAXTPU procedures. 



8 . 1.1 


Beginning and Ending an Editing Session 

To begin an editing session, invoke EVE with the DCL command EDIT/TPU. 
In an editing session, you can create and edit a new file, or you can edit an 
existing file. The session ends when you enter the EXIT or QUIT command. 
Exiting from EVE typically produces a new file or a new version of an existing 
file. 


8.1.1.1 Invoking EVE 

You can start an editing session by creating a new file and inserting text into 
it during the session. You can also begin by spc ifying an existing file when 
you invoke EVE. 

To begin an EVE editing session, enter the DCL command EDIT/TPU. Specify 
a file name on the command line if you want to edit an existing file or assign 
a name to a new file. 

For example, to invoke EVE to create a new file named NEWFILE.DAT, enter 
the following command: 

$ EDIT/TPU MYFILE.DAT 
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8.1 The EVE Editor 


This command produces the following screen output: 
[End of file] 


Buffer NEWFILE.DAT I Insert I Forward 

Editing new file: could not find WORKDISK:[USER]NEWFILE.DAT 

EVE inserts the text of the file you are editing into a temporary holding area 
called a buffer. A buffer is a temporary storage area and exists only during 
an editing session. The contents of the buffer are shown in an area of your 
screen that is called a window. When you end an editing session, you direct 
EVE to save or discard the contents of a buffer. 

The end-of-file marker defines the end of an EVE buffer. It is only visible 
on the screen and does not become part of your file. When you add text to 
the buffer, the end-of-file marker moves downward. The marker may not be 
visible when you are viewing the beginning of a buffer that contains many 
lines of text. 

A highlighted status line appears at the bottom of the EVE window and 
provides information about the EVE buffer. The status line shows the buffer 
name, current mode (insert or overstrike), and current direction (forward or 
reverse). 

If you invoke EVE with a file name, an informational message appears in the 
message buffer beneath the highlighted status line stating either that the file 
is a new file or that a certain number of lines were read from an existing file. 
EVE communicates with you throughout the editing session by displaying 
messages in the Message window. 

To invoke EVE to edit an existing file named OLDFILE.DAT, enter the 
EDIT/TPU command in the following format: 

$ EDIT/TPU OLDFILE.DAT 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer OLDFILE.DAT I Insert I Forward 

4 lines read from file WORKDISK:[USERlOLDFILE.DAT 

When you invoke EVE to edit an existing file, you can use the asterisk 
wildcard character (*) as a substitute for all or some of the characters in the 
file name and file type. You can use the percent wildcard character (%) as a 
substitute for one character in the file name and file type, and you can use the 
ellipsis wildcard ([...]) as a substitute for a directory specification. When 
using wildcards in EVE, follow the same rules as using wildcards in DCL. If 
only one match is made, the file is displayed on your screen. If more than 
one match is made, EVE displays a list of matching files and prompts you to 
provide a more complete file specification. If no match is made, the file name 
that you typed appears in the highlighted status line. The message Editing 
new file. Could not find: is displayed in the message buffer. 
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8.1 The EVE Editor 


You may want to use a command symbol to invoke the EVE editor. For 
example, if you place the following statement in your login command file and 
execute your login command file, you only need to type EVE to invoke the 
EVE editor. 

$ EVE == EDIT/TPU 

Rather than name a file at the beginning of an editing session, you can invoke 
EVE with the command EDIT/TPU and then enter text into the buffer. You 
can save the text by writing it to a file using the WRITE FILE command 
described in Section 8.1.7. Alternately, when you finish creating your file, 
EVE prompts for a file name as follows: 

Enter a file name to write buffer MAIN; else press RETURN: 

Type the name of the file, and press RETURN to write out the buffer to a file. 


8.1.1.2 Ending an Editing Session 

Two different commands can end an EVE editing session. EVE produces 
a new version of the edited file when you end the session with the EXIT 
command. EVE discards your edits when you end a session with the QUIT 
command. Any existing versions of the files remain unchanged regardless of 
how the editing session is ended. 

To save your edited text, use the EXIT command. Enter the EXIT command 
by pressing the F10 key (on VT200-series or VT300-series terminals) or by 
pressing CTRL/Z. 

If you have modified the current buffer, EVE creates a new version of the file 
with the same file name and file type as the original version, with the version 
number incremented by 1. For example, if you use the EXIT command after 
modifying a file named FUN.DAT;1, the output file is named FUN.DAT;2, as 
follows: 


Buffer FUN.DAT | insert I Forward 

4 lines written to file WORKDISK:[USER]FUN.DAT;2 

To exit from a session without saving your edits, use the QUIT command. 

To execute the QUIT command, press the DO key (PF4 on VT100-series 
terminals), type QUIT at the Command: prompt, and press RETURN. For 
example, if you have modified a file named FUN.DAT and enter the QUIT 
command, the following display appears on your terminal screen: 

Buffer FUN.DAT | insert I Forward 

Buffer modifications will not be saved, continue quitting (Y or N)? 

Type Y and press RETURN if you want to quit without saving the edits. If 
you change your mind and decide to save your edits, type N, press RETURN, 
and exit from the file using the EXIT command. 

If you have modified buffers other than the current one, EVE asks if you want 
to save the contents of those buffers. If you type Y, EVE creates new versions 
of any existing files, incrementing the version number by 1. EVE prompts for 
a file name if no file currently exists. 
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8.1 The EVE Editor 


8.1.2 Entering EVE Commands 

Once you have invoked EVE, enter EVE commands to edit and manipulate 
text. There are two ways to enter EVE commands: by pressing predefined 
editing keys and by typing the actual commands. 

8.1.2.1 Using Defined Keys to Enter EVE Commands 

EVE defines some editing keys by default. You can define additional editing 
keys to enter commands or to perform editing operations that you use 
frequently (see Section 8.1.9). The predefined editing keys on VT200-series 
and VT300-series terminals include the minikeypad (located between the 
main keypad and the numeric keypad), certain function keys, and certain 
control key sequences. On VTlOO-series terminals, EVE automatically defines 
most of the numeric keypad keys, the arrow keys, and certain control keys. 
Each predefined editing key performs one editing command. 

Throughout this chapter, EVE editing keys are referred to by their names, 
rather than by their location on the VT200-series, VT300-series, or VTlOO- 
series keyboards. For example, on a VT200-series or VT300-series terminal, 
the DO key is located at the top of the editing keypad and is labeled DO. 

On a VTlOO-series terminal, the DO key is located at the upper right of the 
numeric keypad and is labeled PF4. Figure 8-1 shows the predefined keys on 
the VT200-series and VT300-series terminal. Figure 8-2 shows the predefined 
keys on the VTlOO-series terminal. 
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8.1 The EVE Editor 


You can correct typing mistakes on the EVE command line by pressing DCL 
line-editing keys. Use CTRL/U to erase to the beginning of the line, CTRL/E 
to move to the end of the line, and CTRL/B to recall the last command 
entered. By default, the editing mode of the EVE command line is the same 
as the editing mode of your terminal. (You can change the default prior to 
invoking EVE with the DCL command SET TERMINAL. Once in EVE, you 
can change the editing mode with CTRL/A.) 

To save keystrokes when typing EVE commands, you can use CTRL/B, 
abbreviate commands, use the REPEAT command, or press the DO key. Each 
method of saving keystrokes is described as follows: 

• Press CTRL/B to recall the last EVE command you entered. Pressing 
CTRL/B again recalls the previous command that you entered. Continue 
pressing CTRL/B until the command you wish to execute appears on 
your screen, and press RETURN to enter the command. 

• Abbreviate EVE command names, making sure the abbreviation is 
unambiguous. If you enter an abbreviation that is not unique, EVE 
displays a list of matching commands and prompts you for a choice. Type 
enough additional characters to ensure that the abbreviation is unique, 
and press RETURN to enter the command. You can also abbreviate buffer 
names and, file names. Again, EVE provides a list of choices if you do 
not provide a unique abbreviation. 

• Use the REPEAT command to repeat an EVE command or keystroke. 
Press the DO key, type REPEAT and the number of times it is to 
be repeated, and press RETURN. EVE repeats the next character or 
command you enter the specified number of times. For example, to insert 
the character p in your editing buffer 20 times, press the DO key, type 
REPEAT 20, and press RETURN. Then type p. EVE inserts a p into the 
current buffer 20 times. 

• Press the DO key twice to activate the last command entered. 


8.1.3 Editing Text 

Once you know how to invoke the EVE editor and how to enter commands, 
you can use EVE commands to edit new and existing files. Editing keys and 
commands allows you to position the cursor and perform such text editing 
operations as moving, erasing, and restoring text. 


8.1.3.1 Moving the Cursor 

When editing files with EVE, first you move the cursor to the place in the text 
where you want to perform an editing function. Therefore, the more quickly 
and efficiently you move the cursor through the text, the more time you save 
in your editing session. 
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8.1 The EVE Editor 


The following tables show the EVE editing keys and commands that move 
the cursor: 


Editing Key 

Moves the Cursor to the Following Position 

Up arrow 

Up one line. 

Down arrow 

Down one line. 

Left arrow 

One character or column to the left. 

Right arrow 

One character or column to the right. 

CTRL/E 

End of the current line. 

CTRL/H 

Beginning of the current line. 

Move By Line 

In forward direction: end of the current line or if the 
cursor is already at the end of a line, to the end of the 
next line. In reverse direction: beginning of the current 
line or if the cursor is already at the beginning of a line, to 
the beginning of the previous line. 

Next Screen 

Forward in the current buffer. The number of lines the 
cursor moves depends on the size of the current window. 

Previous Screen 

Backward in the current buffer. The number of lines the 
cursor moves depends on the size of the current window. 


Editing Command 

Moves the Cursor to the Following Position 

BOTTOM 

End of the current buffer. 

BUFFER 

Puts the specified buffer in the current window and moves 
the cursor to the end of the buffer. Creates a new buffer 


if the specified buffer does not exist. 

END OF LINE 

End of the current line. 

GET FILE 

Creates a new buffer containing text of the specified file 
(or an empty buffer if the file does not exist) and puts the 
cursor at the beginning of the buffer. 


If entered a second time with the same file name during 
an editing session, EVE puts the existing buffer in the 
current window and positions the cursor at its last 
location in the buffer. 

LINE 

Beginning of the specified line in the current buffer. 

MOVE BY PAGE 

Next or previous page break, depending on the current 
direction. 

MOVE BY WORD 

Beginning of the next word, if direction is forward. In 
reverse direction, cursor moves to the beginning of the 


current word; if already there, EVE positions cursor at the 
beginning of the previous word. 

NEXT WINDOW 

Next window on your screen, assuming another exists. 
The cursor appears in the last location it occupied in that 
editing window. 
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Editing Command 

Moves the Cursor to the Following Position 

PREVIOUS WINDOW 

Previous window on screen, assuming another window 
exists. The cursor appears in the last location it occupied 
in that editing window. 

SET CURSOR 

BOUND 

Changes cursor mode. Cursor follows the flow of text 
and cannot be put into an unused portion of the buffer. 
Similar to cursor behavior in EDT and other editors. 

SET CURSOR FREE 

The default mode. Cursor is not bound to the flow of the 
text but can be put anywhere on the screen and text can 
be entered. 

START OF LINE 

Beginning of the current line. 

TOP 

Beginning of the current buffer. 


The following example shows how to move the cursor through a buffer. The 
example assumes that you created a file named OLDFILE.DAT in an earlier 
editing session. 

Invoke EVE to edit the file OLDFILE.DAT using the command EDIT/TPU. 
EVE reads the contents of OLDFILE.DAT into a buffer and places the cursor 
at the beginning of the first line of text. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer OLDFILE.DAT | Insert I Forward 

4 lines read from file WORKDISK:[USER]OLDFILE.DAT 

Press CTRL/E to move the cursor to the end of the first line of text. CTRL/E 
works the same way in EVE as it does in DCL. 

Schedule for 1 July! 

10:00 AM meeting with supervisor 
Read and review memo from Donna 
Work on Pascal program 
[End of file] 


Buffer OLDFILE.DAT | Insert I Forward 

4 lines read from file WORKDISK:[USER]0LDFILE.DAT 

Use the BOTTOM command to move the cursor to the end of the buffer. 
Press the DO key, type BOTTOM, and press RETURN. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer OLDFILE.DAT | Insert I Forward 

Command: BOTTOM 
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Press the up arrow to move the cursor to the beginning of the fourth line of 
text. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer 0LDFILE.DAT I Insert I Forward 

Press the Forward Reverse key to change the current buffer direction to 
reverse. Press the Move By Line key to move the cursor to the beginning of 
the third line of text. 


Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer 0LDFILE.DAT I Insert I Reverse 

Press the DO key, type the command LINE 1, and press RETURN to move 
the cursor to the beginning of the first line of text. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer 0LDFILE.DAT I Insert I Forward 

Command: LINE 1 


8.1.3.2 Inserting Text 

You can insert sections of text, entire files, and special nonprinting characters 
(such as control characters) into the buffer you are currently editing. The 
following tables show the editing keys and EVE commands that you use 
while inserting text: 
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Editing Key 

What It Does 

Insert Overstrike 

Changes the current editing mode as displayed 
on the highlighted status line. In insert mode, 

EVE inserts text at the current character position, 
moving existing text to accommodate the insertion. 
In overstrike mode, EVE overwrites text at the 
current position. 

CTRL/A 

Same as the Insert Overstrike key. 

CTRL/V 

Lets you insert nonprinting characters (or control 
codes) in a buffer. You can search for special 
characters using the Find key. First, press the Find 
key, then press CTRL/V and the special character 
to be found, and activate the search by pressing 


RETURN. 


Command 

What It Does 

INCLUDE FILE 

Inserts the entire contents of the specified file 
into a buffer at the line before the current cursor 
location. 


Before you begin inserting text into a buffer, look at the highlighted status line 
to determine whether EVE is in insert or overstrike mode. If EVE is in insert 
mode, text is inserted at the cursor position, and text that already appears 
in the file moves to accommodate your insertions. If EVE is in overstrike 
mode, text that you type at the keyboard is inserted at the cursor position, 
and the text that already appears in the file is overwritten as the cursor moves 
through it. 

Press CTRL/A or the Insert Overstrike key to change from one mode to the 
other. 

You can add text to your buffer in the following ways: 

• Text — Type characters that EVE adds to the buffer at the current cursor 
position. The characters are added according to the current mode of the 
buffer (insert or overstrike). 

• piles — Add entire files by pressing the DO key and entering the EVE 
command INCLUDE FILE. Type the file specification at the File to include: 
prompt and press RETURN. EVE disregards the current mode (insert or 
overstrike) of the buffer and inserts the entire contents of the specified file 
into the buffer just before the line in which the cursor currently appears. 

Wildcards are allowed in the file specification. If there is more than 
one match for a file specification with a wildcard, EVE displays a list of 
choices and prompts you to provide a more complete file specification. 

If the specified file does not exist, EVE displays a message stating that it 
could not include the file. 

• Special Nonprinting Characters — Add special nonprinting characters 
by pressing CTRL/V followed by the special character. For example, to 
insert an escape character into the buffer on a VT200-series or VT300- 
series terminal, press CTRL/V followed by CTRL/3. (On a VT100- 
series terminal, press CTRL/V and then press CTRL/[.) The special 
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characters are added according to the current mode of the buffer (insert or 
overstrike). 

The following example shows how to insert text into a file, first in insert 
< mode and then in overstrike mode. Invoke EVE to edit the existing file 
OLDFILE.DAT. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 

Buffer OLDFILE. DAT =&■■■■■■ | Insert I Forward 

4 lines read from file WORKDISK:[USERjOLDFILE.DAT 

Check the highlighted status line to ensure that EVE is in insert mode. Press 
the Insert Overstrike key (or CTRL/A) to change to insert mode, if necessary. 
Move the cursor to the first s in the word supervisor, type Engineering , and 
press the space bar. 

The word Engineering is inserted in your text buffer, and the rest of the text 
on the line shifts to the right. 

Schedule for 1 July 

10:00 AM meeting with Engineering supervisor 
Read and review memo from Donna 
Work on Pascal program 
[End of file] 

Buffer OLDFILE.DAT | insert I Forward 

4 lines read from file WORKDISK:[USERjOLDFILE.DAT 

Now press the Insert Overstrike key to change to overstrike mode. Move the 
cursor to the letter D in the word Donna and type Andrea. 

The word Andrea is placed in the buffer, overwriting the word Donna. 

Schedule for 1 July 

10:00 AM meeting with Engineering supervisor 
Read and review memo from Andrea 
Work on Pascal program 
[End of file] 

Buffer OLDFILE.DAT | Overstrike I Forward 

4 lines read from file WORKDISK:[USER]OLDFILE.DAT 
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8.1.3.3 Erasing and Restoring Text 

With the EVE editor, you can easily delete text from a file or correct mistakes 
made during an editing session. If you erase text by mistake, you can restore 
the most recently erased text to its former location or, by moving the cursor, 
to another location. The following table shows the editing keys and EVE 
commands that erase and restore text: 


Editing Key 

What It Erases 

<2 

Character to the left of the cursor. 

Erase Word 

Current word or, if the cursor is not on a word, 
erases the next word. 

CTRL/U 

All characters from the current cursor position to 
the beginning of the line. 


Command 

What It Does 

ERASE CHARACTER 

Erases the current character. 

ERASE LINE 

Erases from the current cursor position to the end 
of the current line, appending the next line to the 
end of the current line. 

ERASE PREVIOUS WORD 

Erases the previous word or the word the text 
cursor is on. If you are at the start of a line, you 
erase the carriage return at the end of the previous 
line, and the current line moves up. If you are 
between words or on the first character of a word, 
you erase the previous word. If you are in the 
middle of a word, you erase all of that word (same 
as ERASE WORD). 

RESTORE 

Restores, at the current cursor position, the word, 
sentence, or line that you have erased most 
recently with an EVE command or editing key. 
RESTORE does not restore single characters. 

RESTORE CHARACTER 

Restores, at the current cursor position, the 
character you have erased most recently with an 
EVE command or editing key. 

RESTORE LINE 

Restores, at the current cursor position, the line 
that you have erased most recently with an EVE 
command or editing key. 

RESTORE WORD 

Restores, at the current cursor position, the word 
that you have erased most recently with an EVE 
command or editing key. 


To erase text from your buffer, move the cursor to the location of the text 
that you want to erase, and press the appropriate editing key, or type the 
appropriate EVE command. 

The following example shows how to erase and restore text. Invoke EVE to 
edit the existing file RHYMES.DAT. (This example assumes that you created 
this file in an earlier editing session.) 
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She rhymes with tree, 
also with bee, 
and this one makes three. 
[End of file] 


Buffer RHYMES.DAT | Insert I Forward 

Move the cursor to the letter l in the word also. Press the DO key, type the 
command ERASE LINE, and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT | insert I Forward 

Commmand: ERASE LINE 


EVE erases all characters from the letter / to the end of the line and appends 
the next line to the current line. 

She rhymes with tree, 
a and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert | Forward 

Move the cursor to the letter y in the word rhymes. Press the DO key and 
enter the command ERASE WORD. 

She rhymes with tree, 
a and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert | Forward 

Command: ERASE WORD 

EVE erases the word rhymes and shifts the remaining text to the left. 

She with tree, 
a and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert | Forward 

Move the cursor to the space between the letter a and the word and on the 
second line. Press the DO key and enter the command RESTORE LINE. 

She with tree, 
a and this one makes three. 

[End of file] 

Buffer RHYMES.DAT , Insert , Forward 

Command: RESTORE LINE 

EVE restores the last line that was erased, in this case. Iso with bee,. 
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Move the cursor to the letter w in the word with on the first line. Press the 
DO key and enter the command RESTORE WORD. 


She with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT 
Command: RESTORE WORD 


I Insert I Forward 

EVE restores the last word that was erased, in this case, rhymes. 


She rhymes with tree, 
also with bee, 
and this one makes three. 
[End of file] 


Buffer RHYMES.DAT 


8.1.3.4 


I Insert I Forward 

Section 8.1.3.4 describes the functions of the Select and Remove keys, which 
can be used together to erase text from a buffer. 

Moving Text from One Location to Another 

The following tables describe the functions of the Select, Remove, and Insert 
Here keys as well as the STORE TEXT command, which are used to erase 
text, to move text from one location to another within a buffer in "cut and 
paste" operations, and to duplicate text. For information on how to move text 
from one buffer to another, see Section 8.1.7. 


Editing Key 

What It Does 

Select 

Remove 

Insert Here 

Marks text (highlighting it in reverse video) from the cursor 
location to wherever you move the cursor. To cancel the 
selection, press the Select key again or use RESET. 

Removes the text that was marked with SELECT, and 
places it in the Insert Here buffer. 

Inserts the text from the Insert Here buffer at the current 
cursor location. 


Command 

What it Does 

STORE TEXT 

Copies text that was marked with SELECT or highlighted 
by FIND, placing it in the Insert Here buffer. Text that is 
copied is not removed from its original position. 


To mark text when the buffer is set in a forward direction, place the cursor on 
the first character that you wish to erase. Press the Select key, and then move 
the cursor to one character beyond the last character that you wish to erase. 
(In reverse direction, move the cursor to the last character, not one beyond.) 
The text that will be erased is highlighted in reverse video. (If you decide 
not to remove text from the buffer, press the Select key again to cancel the 
selection.) Press the Remove key. EVE deletes the highlighted text from your 
screen and places it in the Insert Here buffer. 
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You can insert the text at any cursor location by pressing the Insert Here key, 
or you can erase text permanently from your buffer by leaving it in the Insert 
Here buffer. You can insert the text contained in the Insert Here buffer any 
number of times at any cursor location until you select a new section of text 
and put that new text in the Insert Here buffer using the Remove key or the 
STORE TEXT command. The Insert Here buffer contains whatever text was 
last copied or removed. 

The following example shows how to erase and move text from one location 
to another using the Select, Remove, and Insert Here keys. Invoke EVE to 
edit the file RHYMES.DAT. 

Move the cursor to the beginning of the second line of RHYMES.DAT and 
press the Select key. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT | insert | Forward 

Move the cursor to select text. 

Press the down arrow key once. The second line of text is highlighted. Press 
the Remove key. The second line of text is removed from the current buffer. 

She rhymes with tree, 
and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert | Forward 

Remove completed. 

Press the down arrow key once. Press RETURN twice and then press the 
Insert Here key. The text in the Insert Here buffer is inserted at the current 
cursor location. 

She rhymes with tree, 
and this one makes three. 

also with bee, 

[End of file] 


Buffer RHYMES.DAT | Insert I Forward 


The STORE TEXT command allows you to duplicate text in a file. Move the 
cursor to the first line of text and press the Select key. Press CTRL/E to move 
the cursor to the end of the first line and enter the STORE TEXT command 
(Press DO, type STORE TEXT, and press RETURN.) The Insert Here buffer' 
now contains a copy of the selected text. Now move the cursor to the line 
above also with bee and press the Insert Here key. 
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She rhymes with tree, 
and this one makes three. 

She rhymes with tree, 
and also with bee, 

[End of file] 


Buffer RHYMES.DAT I In8ert 1 Forward 

Store text completed. 


8.1.3.5 Locating Text 

Use the Find key to locate specified strings of text in your buffer. Press the 
Find key (PF1 on VTlOO-series terminals). Then type the text string that you 
wish to locate, called the search string, and press RETURN. 

EVE attempts to move the cursor to the beginning of the specified string. 

If the search string contains all lowercase letters, EVE disregards the case 
of letters and locates any occurrence of the string. Thus, the, THe, and thE 
all match the search string the. If the search string contains one or more 
uppercase letters, EVE locates only the occurrences of the string in which the 
case of letters is exactly the same. Therefore, the only match for the search 
string tHis is tHis. 

EVE is sensitive to diacritical (accent) marks and locates only those 
occurrences of the string in which diacritical marks are exactly the same. 

For example, in searching for e, EVE does not locate occurrences of e, e, e, 
or e. 

The current direction of the buffer determines whether EVE first searches in a 
forward or a reverse direction. 

If the editor cannot find the string in the current direction but finds it in the 
opposite direction, EVE prompts you to change direction. To search in the 
opposite direction, type Y. EVE moves the cursor to the first occurrence of 
the string in the opposite direction. The current direction in the highlighted 
status line is not changed, however. 

When EVE finds the search string, the editor highlights it and moves the 
cursor to the first letter of the string. You can use any one of the following 
commands to modify a highlighted search string: REMOVE, FILL RANGE, 
STORE TEXT, LOWERCASE, UPPERCASE, and CAPITALIZE. To cancel 
the highlighting, move the cursor off the search string or enter the RESET 
command. 

If you press the Find key twice, EVE tries to find the next occurrence of the 
search string. 

The following example uses the existing file RHYMES.DAT to illustrate 
the use of the Find key. When you invoke EVE to edit RHYMES.DAT, the 
cursor appears on the first letter of the first line of the buffer, and the current 
direction is forward. 
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She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | Insert | Forward 

3 lines read from file WORKDISK:[USER]RHYMES.DAT 

Press the Find key, type the letters ree, and press RETURN. The cursor moves 
to the letter r in the word tree and highlights the letters ree. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT | j nser t | Forward 

Forward Find: ree 

Press Find twice to find the next occurrence of the string ree. The cursor 
moves to the letter r in the word three and highlights the letters ree. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT 

Finding previous target: ree 


Insert | Forward 


When a search string is found and highlighted, you can use any command 
that works on a selected range. For example, enter the UPPERCASE 
command. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT 

1 Insert 1 Forward 

Command: UPPERCASE 

She rhymes with tree, 
also with bee. 

The UPPERCASE command changes the case of the highlighted letters from 
lowercase to uppercase. 

and this one makes thREE. 

[End of file] 

Buffer RHYMES.DAT 

Forward 


You can also use wildcards to search for a text string. Wildcard characters 
in a search string refer to a group of strings, rather than a specific string. By 
default, EVE searches for text using the VMS wildcard patterns, which include 
the asterisk (*) and percent sign (%). (To display all wildcard patterns for 
VMS, enter the SHOW WILDCARD command.) EVE can also search for text 
using ULTRIX patterns. 

Move the cursor to the s in She. 
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To search for text strings ending in ee, enter the command WILDCARD 
FIND *ee. 

She rhymes with tree, 

also with bee, 

and this one makes thREE. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: WILDCARD FIND *ee 

EVE positions the cursor at the start of the line containing the r in tree. 

The WILDCARD FIND command can also search for a string terminated by 
the Forward Reverse key. The key resets the initial direction of the search, 
overriding the current direction for the buffer. 

You can specify how the FIND command treats the blank spaces between 
words such as spaces, tabs, and line breaks, which is called white space. By 
default EVE treats the white space in a search string literally and does not 
match across a line break. However, if you use the SET FIND WHITESPACE 
command before the search, the FIND command ignores white space when 
searching for a text string. 


8.1.3.6 Marking Locations in Text 

The MARK and GO TO commands are very useful when you are editing a 
large file and know that you want to return to a specific cursor location later 
in the editing session. The following table describes the MARK and GO TO 
commands: 


Command 

What It Does 

MARK 

Associates a unique and invisible label, consisting of 
one or more alphanumeric characters, with the current 
cursor location. The mark exists for the rest of an editing 


session. 

GO TO 

Returns the cursor to the location labeled by the MARK 
command. If the labeled location is contained in another 
buffer, EVE moves the cursor to the other buffer and 
places the buffer in the current window. 


To mark a cursor location, press the DO key, type MARK label-name, and 
press RETURN. The label name can be one or more printable characters, 
including alphanumeric and punctuation characters. To return the cursor to 
the marked location, press the DO key, type GO TO label-name, and press 
RETURN. 

The following example shows you how to use the MARK and GO TO 
commands to mark a cursor position with the label name FIRST and how to 
return to that cursor position. 

Move the cursor to the letter b in the word bee. Press the DO key, type 
MARK and press RETURN. To mark the cursor location with the label FIRST, 
type FIRST at the Mark name: prompt. 
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She rhymes with tree, 
also with bee, 
and this one makes three. 
[End of file] 


Buffer RHYMES.DAT I Insert I Forward 

Mark name: FIRST 


Move the cursor to the letter t of the word three. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT | Insert I Forward 

Current position marked as FIRST 

Press the DO key, type GO TO FIRST, and press RETURN to return the 
cursor to the position labeled FIRST. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Going to mark: FIRST 

8.1.3.7 Replacing Text 

The REPLACE command allows you to replace a text string that appears in 
the current buffer with another text string. This is especially useful if you 
have spelled a word incorrectly throughout a long file, and you want to fix 
every occurrence. 

To use the REPLACE command, press the DO key, type REPLACE, and press 
RETURN. Type the string that you wish to replace at the Old string: prompt 
and press RETURN. Type the new string at the New string: prompt and press 
RETURN. 

If EVE finds the old string in the current direction, it moves the cursor to 
the first occurrence of the old string, highlights the string, and provides the 
following prompt: Replace? Type yes, no, all, last, or quit. 

If EVE does not find the string in the current direction but finds it in the 
opposite direction, EVE provides the following prompt: Found in 'reverse 
/forward’ direction. Go there? [Y]. If you type Y, EVE moves the cursor to 
the first occurrence of the string in the new current direction, highlights the 
string, and provides the following prompt: Replace? Type yes, no, all, last, or 
quit: The current direction of the buffer in the highlighted status line is not 
changed. 

Respond to the prompt by typing a single-character abbreviation of the 
response and pressing RETURN. Simply pressing RETURN is equivalent to 
typing Y and pressing RETURN. The following table explains the possible 
responses and actions when you type these responses: 
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Response 

Replacement Procedure 

Yes 

Replaces the string and attempts to locate another occurrence 
of the string in the current direction. If found, the cursor moves 
to the next occurrence of the string, the string is highlighted, 
and EVE prompts: Replace? Type yes, no, all, last, or quit:. If 
the string is not found in the current direction but is found in the 
opposite direction, EVE prompts: Found in 'reverse/forward’ 
direction. Go there? [Y]. 

No 

Skips this occurrence and searches for another occurrence of the 
string in the current direction. If found, the cursor moves to the 
next occurrence of the string, the string is highlighted, and EVE 
prompts: Replace? Type yes, no, all, last, or quit:. If the string 
is not found in the current direction but is found in the opposite 
direction, EVE prompts: Found in 'reverse/forward' direction. 

Go there? [Y]. 

All 

Replaces the string and all other occurrences of the string in the 
current direction. EVE leaves the cursor at the position where 
the first replacement occurred. After all occurrences of the string 
in the current direction have been replaced, EVE may inform 
you: Found in 'forward/reverse' direction. Go there? [Y]. If you 
type yes, EVE replaces all occurrences of the string in the new 
direction. 

Last 

Replaces this occurrence of the string and stops the REPLACE 
procedure; the cursor does not move. 

Quit 

Does not replace this occurrence of the string and stops the 
REPLACE procedure; the cursor does not move. Pressing 
CTRL/Z has the same effect. 


The REPLACE command is case sensitive. If the old string and the new string 
are given in all lowercase characters, then EVE matches the case appropriately 
for each replacement. For example, in replacing the string parsley with the 
string dill, EVE replaces a capitalized version of parsley with a capitalized 
version of dill. If the old string is lowercase, the search is general. However, 
if the old string is uppercase or mixed case, the search is case-exact. If the 
old and the new strings are lowercase, the replacement mirrors the case of 
the occurrence. Whereas, if the new string is uppercase or mixed case, the 
replacement is exact. 

After finding the old string and prompting for the replacement of all 
occurrences of the string in both directions, EVE continues to search the 
buffer for the string. If EVE finds more occurrences, it informs you: Found in 
forward/reverse direction. (May have already been replaced.) Go there [N]? The 
default answer is N to prevent you from replacing the occurrences a second 
time. 

The following example shows how to use the REPLACE command to replace 
every occurrence of the string ee with the string oo. Move the cursor to the 
top of the buffer. Press the DO key, type REPLACE, and press RETURN. 
Type ee at the highlighted Old string: prompt, press RETURN, and type oo at 
the highlighted New string: prompt. 
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She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Old string: ee 

The cursor moves to the highlighted string ee in the word tree. Type all, and 
press RETURN. All occurrences of the string ee are replaced with the 
string oo. 

She rhymes with troo, 

also with boo, 

and this one makes throo. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Replace? Type yes, no, all, last, or quit: all 


8.1.4 Using the HELP Facility 

EVE has an online HELP Facility that quickly supplies information on editing 
commands and keys during your editing session without disturbing your 
work. You can obtain help by entering the HELP command or by pressing 
the Help key. 

To view a list of EVE commands, press the DO key and enter HELP. Use 
the Previous Screen and Next Screen keys (up and down arrow keys on a 
VTlOO-series terminal) to scroll through the entire list of EVE commands. To 
get information on a particular command, type a command name after the 
help prompt and press RETURN. The help text appears on the screen. 

If you know the name of a specific command for which you need help, 
press the DO key, type HELP followed by the name of the command, and 
press RETURN. The help text for that command appears on the screen. 

For example, to receive help on the MOVE BY LINE command, enter the 
command HELP MOVE BY LINE. The following help text appears on your 
screen: 


.MOVE BY LINE 

Moves the text cursor a line at a time in the current direction (shown in 
the status line). 

o In FORWARD direction, the cursor moves to the end of the current line 
or if already there, to the end of the next line (if any). 

o In REVERSE direction, the cursor moves to the start of the current line 
or if already there, to the start of the previous line (if any). 

Keys: By default, key F12 is defined as MOVE BY LINE. The VT100 keypad 
defines MINUS on the keypad. 

Related topics: 

END OF LINE LINE START OF LINE WHAT LINE 


Buffer HELP 

Type topic name or ? for list. Press Return if done: 
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The HELP Facility also provides information on general topics. For example, 
if you choose to use the EDT or the WPS keypad, use the command HELP 
SET KEYPAD EDT or the command HELP SET KEYPAD WPS to get 
information on changing your default keypad. To display a list of all defined 
keys for the keypad you are using, enter the command HELP KEYS. There 
is also help on the difference between an EDT keypad within EVE and the 
original EDT keypad (HELP EDT DIFFERENCES). 

The Help key produces a keypad diagram for the keypad you are using. The 
diagram shows both the default editing keys and the keys you have defined 
for the minikeypad (LK201 keyboard), the main keypad, the keys F10-F14 
(LK201 keyboard), and the GOLD key (described in Section 8.1.9.3). 

You can get help on particular editing keys after you display the keypad by 
pressing the desired key. If you press a key to which you have assigned an 
EVE command, EVE provides the help text for that EVE command. 


8.1.5 Recovering from System Interruptions 

EVE has recovery procedures for two types of system interruptions. You 
can remove extraneous characters that appear on your screen. You can also 
recover edits from an interrupted editing session with the journaling facility. 


8.1.5.1 Refreshing the Screen 

If extraneous characters, such as a message from the operator, appear on your 
terminal screen while you are editing or inserting text, press CTRL/W to 
refresh your screen. The screen becomes blank, and then all characters are 
redrawn, minus any extraneous characters. 


8.1.5.2 Using the Journal File 

If you are editing a file and a system interruption (that is, a break in 
communication between your terminal and the computer) occurs, you can 
recover your lost editing session. By default, EVE records the keystrokes you 
enter during an editing session in a journal file that has the same file name as 
the file you are editing and a file type of TJL. 

Typically, an editing session ends without interruption, so the system deletes 
the journal file. When you experience a system interruption, however, the 
journal file is saved. EVE can use the journal file to reconstruct your editing 
session so that only the last few keystrokes of your editing session are lost. 

To recover an editing session, enter the command you used to invoke EVE 
with the /RECOVER qualifier. For example, to recover an editing session 
you began with the command EDIT/TPU LETTER.RNO, type the following 
command and file name and press RETURN: 

$ EDIT/TPU/RECOVER LETTER.RNO 

You must recover an editing session at a terminal of the same type as the one 
you used for your editing session. When EVE finishes recovering the session, 
check to ensure that the last few keystrokes of your editing session were 
recovered and continue editing the file. If another system interruption occurs 
before you exit, a journal file containing the keystrokes from both editing 
sessions is saved. 
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The journal file is saved in the current default editing directory. However, 
you can create a journal file in another directory using the /JOURNAL 
qualifier: 

$ EDIT/TPU/J0URNAL=[ALEXIS.JOURNEYS]LETTER.TJL LETTER.RNO 

If you use the /JOURNAL qualifier to create a journal file with a different 
file name or a different directory, you must use the /JOURNAL qualifier 
and the file name when you recover the file. For example, to recover the file 
LETTER.RNO when the journal file is in directory [ALEXIS.JOURNEYS], enter 
the following command: 

$ EDIT/TPU/J0URNAL=[ALEXIS.JOURNEYS]LETTER.TJL/RECOVER LETTER.RNO 

The journaling facility has the following restrictions: 

• If you use the WRITE FILE command during your editing session to copy 
the contents of the buffer to another file, you need to recover the original 
version of the file that you were editing. That is, you must specify the 
original version number in order to recover your file. For example, if 
you are editing an existing file called LETTER.RNO;l and use the WRITE 
FILE command, EVE creates LETTER.RNO;2. If you experience a system 
interruption, you must enter the original version of LETTER.RNO on 
the EDIT/TPU/RECOVER command line. In this example it would be 
LETTER.RNO;l. See Section 8.1.7.4 for more information on the WRITE 
FILE command. 

• EVE is usually unable to recover keystrokes entered after you press 
CTRL/C. If you press CTRL/C, end the editing session immediately with 
the EXIT command and invoke EVE again. 


8.1.6 Formatting Text 

EVE provides commands that enable you to format your text by setting 
margins, tabs, screen width, and word wrap. It allows you to center lines, 
take extra white space out of text, and insert page breaks. The following table 
lists text formatting commands and describes their functions: 


Command What It Does 


CAPITALIZE WORD 
CENTER LINE 

FILL 

FILL PARAGRAPH 
FILL RANGE 


Capitalizes a single word or each word in the text 
highlighted by FIND or SELECT. 

Centers the line of text marked by the cursor between 
the current left and right margins. The text cursor 
moves with the line, remaining on the same character 
as the line moves. 

Reformats the current paragraph or selected range 
according to the margins of the buffer, so the maximum 
number of words fits on a line. 

Reformats the paragraph the text cursor identifies 
according to the margins set for the buffer. 

Reformats the currently selected range of text (or the 
current FIND range) according to the current margin 
settings. 
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Command 

What It Does 

INSERT PAGE BREAK 

Inserts a form feed character at the current editing 
position to mark the beginning of a new page. A page 
break appears as a small double-F and is always on a 
line by itself. By default, CTRL/L inserts a page break. 

LOWERCASE WORD 

Makes a single word or the text highlighted with FIND 
or SELECT all lowercase. 

SET LEFT MARGIN 

Sets the left margin in current buffer. The left margin 
must be greater than 0 but less than the right margin. 
By default, the left margin is 1. 

SET RIGHT MARGIN 

Sets the right margin for the current buffer. The 
right margin must be greater than the left margin. By 
default, the right margin is one less than the screen 
width. The width is typically 80, so the default margin 
is typically 79. 

SET TABS AT 

Sets tab stops at the columns that you specify. 
Columns are specified as a sequence of positive 
integers separated by spaces. By default, tab stops 
are set in every eighth column. This command does 
not affect the hardware tab settings of your terminal. 

SET TABS EVERY 

Sets tab stops at the specified interval. By default, tab 
stops are set in every eighth column. This command 
does not affect the hardware tab settings of your 
terminal. 

SET TABS INSERT 

Turns on tab insert mode, so that EVE sets a tab stop 
at the column where you press the Tab key, moving 
over text currently on the screen. SET TABS INSERT 
is the default mode. 

SET TABS SPACES 

Changes tab mode to insert an appropriate number of 
spaces rather than a tab character when the Tab key 
is pressed. Previously existing tab characters are not 
affected. 

SET TABS MOVEMENT 

Changes the tab mode so the Tab key becomes a 
cursor-control key. Pressing the Tab key moves the 
cursor to the next tab stop but does not insert a tab 
character. 

SET TABS VISIBLE 

SET TABS INVISIBLE 

Displays tabs as visible characters on the screen. 

Does not display tabs as visible characters on the 
screen. SET TABS INVISIBLE is the default mode. 

SET WIDTH 

Sets the width of lines displayed on the screen. 
Specify width as a positive integer n. By default, 
screen width is your terminal setting, typically 80 
columns. If n is greater than 80, EVE sets the terminal 
to 132-column mode for the current editing session. 
When the EVE session is terminated, the terminal 
is restored to the default setting. Setting the width 
changes the display of text in all windows. 
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Command 

What It Does 

SET WRAP 

Enables word wrapping at the right margin of the buffer 
so EVE starts new lines without a RETURN command 
or use of the FILL command. SET WORD WRAP is the 
default setting. 

SET NOWRAP 

Disables word wrapping at the right margin of the 
buffer. You must start new lines by pressing RETURN 
or by using the FILL command. 

SHIFT LEFT 

Moves the current window to the left a specified 
number of columns. The SHIFT LEFT command can 
be used only to reverse the effect of the SHIFT RIGHT 
command. 

SHIFT RIGHT 

Moves the current window to the right a specified 
number of columns, allowing you to view columns of 
characters that do not currently appear on the terminal 
screen. 

UPPERCASE WORD 

Makes a single word or the text highlighted with FIND 
or SELECT all uppercase. 


The following example shows how to use EVE commands to set margins and 
screen width and to shift the current window: Invoke EVE to edit the existing 
file RHYMES.DAT. Press the DO key, type SET LEFT MARGIN 20, and press 
RETURN to set a left margin of 20. The text that currently appears in the 
buffer does not change. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: SET LEFT MARGIN 20 

Move the cursor to the end of the buffer and type the following new text: 
Also with thee, and me. The new text that you enter is inserted at the left 
margin of 20. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Left margin set to 20 
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Reset the left margin to 1. Press the DO key, type SET LEFT MARGIN 1, and 
press RETURN. Again, the text that currently appears in the buffer does not 
change. When you insert new text, it is inserted at a left margin setting of 1. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me.! 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: SET LEFT MARGIN 1 

Next, set the right margin to 25 by pressing the DO key, typing SET RIGHT 
MARGIN 25, and pressing RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: SET RIGHT MARGIN 25 

Enter the following new text in your file and notice that it wraps automatically 
to the next line at a right margin of 25. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Right margin set to 25 

To reset the right margin to 79, press the DO key, type SET RIGHT MARGIN 
79, and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Right margin set to 79 
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Now, set the width of your text window to 20 by pressing the DO key, typing 
SET WIDTH 20, and pressing RETURN. 

She rhymes with tre 
also with bee,# 
and this one makes 
And free, and fee,# 
see, and brie, and# 
number of other wor 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: SET WIDTH 20 

The appearance of the current text window changes; all text beyond the 
twentieth column disappears from the screen. Press the DO key, type SHIFT 
RIGHT 5, and press RETURN to view five columns of text beyond the right 
boundary of the window. 

The window shifts five columns to the right, and you can see characters that 
were not visible before the shift operation. 

ymes with tree, 
with bee, 

his one makes three. 

Also # 
me. 

ree, and fee, and 
and brie, and any 
r of other words.i 

[End of file] 

Buffer RHYMES.DAT J Insert | Forward 

Command: SHIFT RIGHT 5 


Shift the window to its original location by pressing the DO key, typing 
SHIFT LEFT 5, and pressing RETURN. 

She rhymes with tre 

also with bee, 

and this one makes # 

And free, and fee, # 
see, and brie, and 
number of other wor 

[End of file] 

Buffer RHYMES.DAT | Insert I Forward 

Command: SHIFT LEFT 5 

Set the screen width to 80 by pressing the DO key, typing SET WIDTH 80, 
and pressing RETURN. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 
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[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: SET WIDTH 80 

EVE sets the width of lines on your screen to 80. 

The following example shows how to fill a highlighted section of text and 
how to fill a paragraph. Using the existing file RHYMES.DAT, set the left 
margin to 5 and the right margin to 55. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: SET RIGHT MARGIN 55 

Next, fill a highlighted section of text by selecting the first three lines of text 
(with the Select key) and entering the FILL command. Press the DO key, 
type the command FILL, and press RETURN. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: FILL 

EVE fills the highlighted text between the left margin of 5 and the right 
margin of 55. 

She rhymes with tree, also with bee, and this one 
makes three. 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

For EVE, a paragraph is defined by blank lines, the top or bottom of the 
buffer, or page breaks. To compress text in a paragraph, put the cursor 
anywhere in the text of a paragraph, press the DO key, type the command 
FILL PARAGRAPH, and press RETURN. 
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She rhymes with tree, also with bee, and this one 
makes three.! 

Also with thee, and 
me. 

And free, and fee, and 
see, and brie, and any 
number of other words. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: FILL PARAGRAPH 

EVE fills the paragraph according to the margins set for the buffer, in this 
case 5 and 55. 

She rhymes with tree, also with bee, and this one 
makes three. Also with thee, and me. And free, and 
fee, and see, and brie, and any number of other 
words. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

To center a line of text, put the cursor anywhere on the line you want to 
center. For example, to center the text words in the last line of RHYMES.DAT, 
put the cursor on the w. Press the DO key, type the command CENTER 
LINE, and press RETURN. 

She rhymes with tree, also with bee, and this one 
makes three. Also with thee, and me. And free, and 
fee, and see, and brie, and any number of other 
words. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: CENTER LINE 

The command centers the line of text between the current left and right 
margins; in this example, the left margin is set at 1 and the right margin is set 
at 55. The cursor moves with the line, remaining on the character w as the 
line is centered. 

The EVE commands that change the case of text—CAPITALIZE, 
UPPERCASE, and LOWERCASE—work either on a selected range of text 
or on the word the cursor is on. 

To change the case of the first line of text, move the cursor to the word she 
and press the Select key. To mark the end of the selection, move the cursor to 
the end of the line, press the DO key, and enter the command UPPERCASE. 

SHE RHYMES WITH TREE, ALSO WITH BEE, AND THIS ONE 
makes three. Also with thee, and me. And free, and 
fee, and see, and brie, and any number of other 
words. 


[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: UPPERCASE 
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To change the case of a particular word, position the cursor on the word, 
press the DO key, and enter the appropriate case-changing command. Once 
EVE changes the case of the word, the cursor moves to the next word or to 
the end of the line. If the cursor is between two words, the case of the word 
to the right of the cursor is changed, and the cursor moves to the end of the 
word. 


8.1.7 Using Buffers 


Buffers are storage areas that exist only during an editing session. The 
following table describes EVE commands used to create, manipulate, and 
delete buffers: 


Command 

What It Does 

BUFFER 

Puts the specified buffer in the current window and moves 
the cursor to the last location it occupied in that buffer. 
Creates a new buffer if the specified buffer does not exist. 

DELETE BUFFER 

Deletes the buffer you specify. 

GET FILE 

Creates a new buffer that contains the text of the 
specified file (or an empty buffer if you specify a file 
that does not exist); places the new buffer in the current 
window; and places the cursor at the beginning of the 
new buffer. If you specify the same file again during an 
editing session, GET FILE places the buffer in the current 
window. If you specify the same file name and file type 
with a different device or directory name during an editing 
session, EVE prompts you for a different buffer name into 
which to read the file. 

GO TO 

Returns the cursor to the location labeled by the MARK 
command. If the labeled location is contained in another 
buffer, EVE moves the cursor to the other buffer and 
places the buffer with the label in the current window. 

SHOW 

Displays information about the buffers you have created 
during the editing session. If more than one buffer is 
active in your editing session, EVE displays information 
about the buffer you are currently editing. For information 
on other buffers, press the DO key. To resume editing, 
press any other key. 

SHOW BUFFERS 

Lists the buffers you have created during an editing 
session. You can move the cursor through the list and 
specify a particular buffer for viewing using the Select 
key. 

SHOW SYSTEM 

Lists the system buffers created by EVE. You can move 

BUFFERS 

the cursor through the list and specify a buffer for viewing 
using the Select key. 

WRITE FILE 

Writes the contents of the current buffer to a file. If 
you do not specify a file name, EVE uses the buffer 
name as the file name. If you created the current buffer 
with the BUFFER command, EVE prompts you for a file 
specification. 
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When you invoke EVE to edit an existing file, EVE reads the contents of the 
file into a buffer. The highlighted status line contains the buffer name, editing 
mode, and current direction of the buffer. 

To display more information about the current buffer, enter the SHOW 
command. The information displayed includes buffer name, name of the 
input and output files, whether the buffer has been modified, current mode 
and direction, number of lines, margin and screen-width settings, tab-stop 
settings, and marks that have been defined in the buffer. If more than one 
buffer is active during an editing session, you are prompted to press the DO 
key to receive information about the other buffers. 

To delete a buffer, enter the DELETE BUFFER command, specifying the 
name of the buffer you wish to delete. For example, the command DELETE 
BUFFER MYFILE.TXT deletes the buffer called MYFILE.TXT. The buffer name 
must be typed in full; no abbreviations are allowed. 

If the buffer (in this example, MYFILE.TXT) has been modified, EVE issues 
the following prompt to confirm that you want to delete the buffer:. That's a 
modified buffer. Type delete—only, write—first, or quit. 

If you are viewing a buffer that you want to delete, EVE replaces the buffer 
with the oldest buffer existing in the editing session. 


8.1.7.1 Listing Buffers 

To display a list of all buffers you have created during an editing session, 
enter the SHOW BUFFERS command. You can scroll through the list and 
specify a buffer you want to view or any buffers you want to delete. To 
display a buffer in your current window, move the cursor to the buffer name 
and press the Select key. To delete a buffer, move the cursor to the buffer 
name and press the Remove key. 

These applications of the Select and Remove keys apply only when you are 
viewing a list of buffers. 

To display a list of all buffers that EVE has created, enter the SHOW SYSTEM 
BUFFERS command. You can scroll through the list and specify a buffer you 
want to view by moving the cursor to the buffer name and pressing the Select 
key. EVE puts the buffer in your current window. 

Note: Do not delete system buffers because these buffers are necessary for some 
commands to work properly. 


8.1.7.2 Displaying the Contents of the Messages Buffer 

EVE uses the Messages window, which appears at the bottom of the screen, 
to communicate error and informational messages during an editing session. 
The Messages window displays the last message in the Messages buffer. 

You can display these messages with the BUFFER command. To display the 
contents of the Messages buffer, enter the command BUFFER MESSAGES. 
To return to the buffer you were editing, enter the BUFFER command 
followed by the name of the appropriate buffer. For example, to return to 
the buffer named RHYMES.DAT, you would enter the command BUFFER 
RHYMES.DAT. Alternately, you can enter the SHOW BUFFERS command 
to display the buffers you have created. Use the Select key to specify the 
appropriate buffer. 
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8.1.7.3 Editing Two Buffers 

During an editing session, you can use several buffers if you want to edit 
more than one file or if you want temporary storage areas for manipulating 
blocks of text. Multiple buffers are especially useful if you want to copy text 
from one file to another. 

To create a new buffer, enter the GET FILE command and the name of the 
file you want to copy to the new buffer. You can use the asterisk wildcard 
character (*) as a substitute for all or some of the characters in the file name 
and file type. You can use the percent wildcard character (%) as a substitute 
for one character in the file name and file type. You can use the ellipsis 
wildcard ([...]) as a substitute for a directory specification. 

If the specified file exists, EVE reads the contents of the file into a new buffer 
and displays the buffer in the current window. If there is more than one 
match for a wildcarded file specification, EVE displays a list of choices and 
prompts you to provide a more complete file specification. Otherwise, EVE 
creates an empty buffer and displays the buffer in the current window. 

To change the buffer in the current window, press the DO key, type BUFFER 
and the name of the buffer you want to display on the screen, and press 
RETURN. If you forget a buffer name, enter the SHOW BUFFERS command 
to display the names of active buffers in your editing session, and specify a 
buffer with the Select key. 

The following example shows how to use two buffers to edit two files during 
an EVE editing session. This example assumes that the original versions of 
files RHYMES.DAT and OLDFILE.DAT exist in your current default directory. 
Invoke EVE to edit the file RHYMES.DAT. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

3 lines read from WORKDISK:[USER]RHYMES.DAT 

Press the DO key, type the command GET FILE OLDFILE.DAT, and press 
RETURN to create a new buffer that contains the most recent version of 
OLDFILE.DAT. 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer OLDFILE.DAT I Insert I Forward 

Now that you have two buffers, practice copying from one buffer to another. 
Place the cursor on the letter R in the word Read, and press the Select key. 
Press the down arrow once and the third line of OLDFILE.DAT is highlighted. 
Press the Remove key to place the selected line in the Insert Here buffer. 
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Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer 0LDFILE.DAT 

1 Insert I Forward 

Move the text cursor to select text. 




The text from OLDFILE.DAT remains in the Insert Here buffer until you 
overwrite it with other selected text. Now switch to the other buffer to 
resume editing RHYMES.DAT. Press the DO key, type the command BUFFER 
RHYMES.DAT, and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT 

1 Insert I Forward 


Press the Insert Here key. The text from the Insert Here buffer that was 
removed from the buffer OLDFILE.DAT is inserted in the top of the buffer 
RHYMES.DAT. 

Read and review memo from Donna 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT 

1 Insert I Forward 


If you exit from an editing session in which you have modified multiple 
buffers, EVE writes the contents of the current buffer to a file and then asks 
you whether you want to write each of the other modified buffers to files. 


8.1.7.4 Reading and Writing Files 

There are three ways to read a file into an EVE buffer: 

• Invoke EVE with a file specification. 

• Enter the INCLUDE FILE command and the name of the file you want to 
include. EVE reads the entire contents of a file into a buffer just before 
the line where the cursor is located. Using the INCLUDE FILE command 
does not change the name of the buffer on the status line. 

• Enter the GET FILE command and the name of the file you want to use. 
This command creates a new buffer and reads the contents of an existing 
file into the buffer. The name of the buffer on the status line is the same 
as the file name you specified with the GET FILE command. (See Section 
8.1.7.3.) 

To write the contents of the current buffer to a file, enter the WRITE 
FILE command. You can include a file specification with the WRITE FILE 
command. If you do not include a file specification, EVE writes the file using 
the input file specification. If you created the current buffer with the BUFFER 
command, EVE prompts you for a file specification to which it writes the file. 
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If you have used the WRITE FILE command in an editing session and you 
experience a system interruption, you can recover the editing session. See 
Section 8.1.5 for information. 


8.1.8 



Using Windows 

During an EVE editing session, the text buffer you are editing is displayed on 
the screen in a window. A highlighted status line appears at the bottom of a 
window identifying the name, current editing mode, and current direction of 
the buffer. 

EVE allows you to view more than one window on your terminal screen at 
the same time. For example, you can have two windows in order to view and 
edit different sections of the same buffer. 

The following table describes EVE commands used to create and manipulate 
windows: 


Command 

SPLIT WINDOW 


TWO WINDOWS 
NEXT WINDOW 
PREVIOUS WINDOW 
OTHER WINDOW 
ONE WINDOW 
DELETE WINDOW 

ENLARGE WINDOW 


SHRINK WINDOW 


Effect in a Window Environ ment __ 

Splits the window that the cursor is in, forming two 
smaller windows. Adding an argument to the command 
allows you to divide the window into more than two 
parts. For example, SPLIT WINDOW 3 splits the window 
into 3 windows. 

Synonymous with the SPLIT WINDOW command. 

Puts the text cursor in the next (or other) window. 

Puts the text cursor in the previous (or other) window. 
Synonymous with the NEXT WINDOW command. 
Restores the current window as a single, large window. 

Deletes the window the text cursor is in, assuming you 
are using more than one window. 

Enlarges the current window by a specified number of 
lines. For example, ENLARGE WINDOW 5 enlarges the 
window the text cursor is in by 5 lines. The adjacent 
window shrinks accordingly. 

Shrinks the current window by a specified number of 
lines. For example, SHRINK WINDOW 5 shrinks the 
window the text cursor is in by 5 lines. The adjacent 
window is enlarged accordingly. 


8 . 1 . 8.1 



Editing One Buffer 

To view or edit two sections of a file at the same time, use the SPLIT 
WINDOW command. EVE splits your screen and creates two identical 
windows. The cursor maintains its position in the buffer but appears only in 
the bottom window. Notice that the buffer name in each of the status lines is 
the same. 
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Now you can edit different sections of a single file. Any edits that you make 
in one window are made simultaneously in the other window. Unless you 
are viewing two different sections of a file, you can see EVE incorporate edits 
simultaneously in the two windows. 

Displaying two sections of a long file makes moving text within a file very 
efficient. You can select and remove text from one part of the file and insert 
it into the other. To move the cursor from one window to the other, enter the 
NEXT WINDOW command. 

To remove the second window from the screen and expand the current 
window to occupy the whole editing area, press the DO key, type ONE 
WINDOW, and press RETURN. 

8.1.8.2 Editing Two Buffers 

The following steps describe how to edit two buffers containing different files: 

1 Invoke EVE to edit a file. 

2 Create two windows by entering the command SPLIT WINDOW. EVE 
splits your screen and creates two windows. The cursor maintains its 
position in the buffer but appears only in the bottom window. Notice 
that the buffer name in each of the highlighted status lines is the same. 

3 Put a different buffer in the current window using either the GET FILE or 
the BUFFER command. 

To create a new buffer in the current window, use the GET FILE 
command with a file specification. 

Or, to display a buffer that you created earlier in the editing session in 
the current window, enter the BUFFER command and the name of the 
buffer you want to display. 

EVE replaces the current buffer with the buffer named with the GET FILE 
command or the BUFFER command. 

4 Your terminal screen now displays two different buffers. You can select 
and remove text from one buffer and insert it into the other buffer. To 
move the cursor from one window to the other, enter the command 
NEXT WINDOW. 

The following example shows you how to edit two files and move text from 
one file to another using two windows. First, invoke EVE to edit the file 
RHYMES.DAT. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

3 lines read from file WORKDISK:[USERlRHYMES.DAT 

Press the DO key, type the command SPLIT WINDOW, and press RETURN 
to create two windows on your screen. 
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She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 


Buffer RHYMES.DAT I Insert I Forward 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Command: SPLIT WINDOW 

Press the DO key, type the command GET FILE OLDFILE.DAT, and press 
RETURN to create a new buffer containing the text of OLDFILE.DAT in the 
bottom window of your screen. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


Buffer OLDFILE.DAT I Insert I Forward 

4 lines read from file WORKDISK:[USERlOLDFILE.DAT 

Move the cursor to the letter R in the word Read, press the Select key, 
and press the down arrow twice. The last two lines in OLDFILE.DAT are 
highlighted. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Schedule for 1 July 

10:00 AM meeting with supervisor 

Read and review memo from Donna 

Work on Pascal program 

[End of file] 


I Insert I Forward 


Buffer OLDFILE.DAT 

Move the text cursor to select text. 
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Press the Remove key to place the highlighted text in the Insert Here buffer. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Schedule for 1 July 

10:00 AM meeting with supervisor 

[End of file] 


Buffer 0LDFILE.DAT 

1 Insert I Forward 

Remove completed. 

Enter the NEXT WINDOW command to move the cursor to the other 
window. Move the cursor to the bottom of the buffer and press the Insert 
Here key. The text that you removed from OLDFILE.DAT is inserted into 
RHYMES.DAT. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

Read and review memo from Donna 

Work on Pascal program 
[End of file] 

Buffer RHYMES.DAT 

1 Insert I Forward 

Schedule for 1 July 
10:00 AM meeting with 
[End of file] 

supervisor 


Buffer 0LDFILE.DAT | insert I Forward 

Enter the ONE WINDOW command to remove all other windows from the 
screen and expand the window containing the cursor to occupy the whole 
editing area of the screen. Press the DO key, type ONE WINDOW, and Dress 
RETURN. ’ V 

If you exit from the editing session, EVE writes the contents of the current 
buffer to a file. EVE prompts Write buffer? if another modified buffer exists. 
To write the contents of the other buffer to a file, type Y. 
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8.1.9 Defining Keys 

You can define keys to execute EVE commands or to enter a series of 
keystrokes. 

EVE does not allow you to define the RETURN key (CTRL/M), the space 
bar, or any printing characters (such as letters, digits, and punctuation marks) 
on the main keyboard. In addition, DIGITAL recommends that you do not 
define the following keys and control key sequences: 

DELETE O 

F6 (VT200- and VT300-series) 

Help (PF2 on VT100-series) 

CTRL/C 

CTRL/I (Tab key) 

CTRL/R 

CTRL/S 

CTRL/T 

CTRL/Q 

CTRL/U 

CTRL/X 

CTRL/Y 

You can define all other keys, including control keys. You can redefine the 
DO key, as long as you assign the DO command to another key. 

8.1.9.1 Defining Keys to Execute an EVE Command 

The DEFINE KEY command assigns an EVE command to a single key or 
control key sequence. You can, in effect, create your own editing keys to 
enter EVE commands that you use frequently. If you press a key to which 
you have assigned an EVE command, EVE provides the help text for that 
EVE command. Key definitions are discarded when you terminate an EVE 
editing session unless you use the SAVE EXTENDED EVE command (see 
Section 8.1.9.4) to save key definitions from one editing session to the next. 

To define a key, do the following: 

1 Press the DO key, enter the command DEFINE KEY, and press RETURN. 

2 Type the EVE command that you want to assign to the key and press 
RETURN. 

3 Press the key to be associated with the EVE command. 

The message Key defined appears if you have successfully defined a key. 

You can also assign EVE commands to keys by creating an initialization file. 
The initialization file contains EVE commands that EVE executes when you 
invoke the editor. Each command line in the initialization file should contain 
a DEFINE KEY command. The command syntax is as follows: 

DEFINE KEY [=key-name] command 

The first parameter is the key to be defined, and the second parameter is the 
command to assign to the key. For example, the following command line 
assigns the MOVE BY WORD command to keypad key 1: 

Command: DEFINE KEY=KP1 MOVE BY WORD 
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The following command assigns the FILL command to CTRL/F: 

Command: DEFINE KEY=CTRL/F FILL 

You can use three different separators when specifying key names: an 
underscore, a hyphen, or a slash. For example, the CTRL/F key can appear 
as CTRL_F, CTRL-F, or CTRL/F. 

To remove a key definition, use the UNDEFINE KEY command. 

Section 8.1.9.3 contains more examples of defining keys to execute EVE 
commands. 


8.1.9.2 Defining Keys to Enter a Learn Sequence 

The LEARN command assigns a sequence of keystrokes called a learn 
sequence to a single key or control key. Learn sequences allow you to enter 
the same series of keystrokes in a buffer any number of times by pressing 
one key. If you press a key to which you have assigned a learn sequence, 
EVE provides a HELP message stating that you have defined the key; the 
HELP diagram labels as sequence any keys to which you have assigned a 
learn sequence, but does not describe what the key sequence is. All learn 
sequences are discarded when you terminate an EVE editing session unless 
you use the SAVE EXTENDED EVE command (see Section 8.1.9.4). 

Define a learn sequence as follows: 

1 Press the DO key, enter the LEARN command, and press RETURN. 

2 Type the keystrokes to be remembered. 

3 Press CTRL/R followed by the key to be associated with the learn 
sequence. 

The message Key sequence remembered appears if you have successfully 
defined a key. 

The following example shows how to define a learn sequence that will insert 
a string of text into your file when you press CTRL/F. Invoke EVE to edit the 
file RHYMES.DAT. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

3 lines read from file WORKDISK:[USERjRHYMES.DAT 

First, move to the end of the buffer. To begin the definition of the learn 
sequence, enter the LEARN command. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: LEARN 
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Insert the text And what is a rhyme? at the end of your file. This is the text 
that EVE is to remember. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

And what is a rhyme? 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Press keystrokes to be learned. Press CTRL/R to remember these keystrokes. 

Press CTRL/R. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

And what is a rhyme? 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward| 

Press the key that you want to use to see what was just learned: 

Press CTRL/F, the key to which you are assigning the learn sequence. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

And what is a rhyme? 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Key sequence remembered 

For the rest of the editing session, press CTRL/F to insert the text And what is 
a rhyme? at the current cursor position. 


8.1.9.3 Defining a GOLD Key 

You can assign two editing functions to one editing key if you create a 
GOLD key. One editing function is performed by pressing the editing key. 
The other function is performed by first pressing the GOLD key and then 
pressing the same editing key. To define a GOLD key, enter the SET GOLD 
KEY command and press the key you want to use as the GOLD key. Once 
defined, the message GOLD key set. appears in the Messages buffer. 

Once you have defined a GOLD key, you can use the GOLD editing keys 
that EVE predefines (on VT200-series and VT300-series terminals). To see a 
diagram of these commands, enter HELP KEYPAD. The GOLD editing keys 
appear in reverse video. 

You can also create your own key definitions using the GOLD key. The 
following example demonstrates how to define a GOLD key and assign two 
commands to a single key. The example defines the number 4 key on the 
numeric keypad as the GOLD key and then assigns the BOTTOM and TOP 
commands to the CTRL/G key. Thus, pressing CTRL/G alone enters the 
BOTTOM command, and pressing the GOLD key followed by CTRL/G 
enters the TOP command. 


8-41 









Editing Files with the EVE and EDT Editors 

8.1 The EVE Editor 


Invoke EVE to edit the file RHYMES.DAT. Define a GOLD key by pressing 
DO, typing SET GOLD KEY, and pressing RETURN. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | Insert I Forward 

Command: SET GOLD KEY 


Press the number 4 key on the numeric keypad. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | Insert | Forward 

Press the key that you want to use as the GOLD key: 

GOLD key set 


Press the DO key, type DEFINE KEY, and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | Insert | Forward 

Command: DEFINE KEY 


Type BOTTOM and press RETURN. 


And what is a rhyme? 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | Insert | Forward 

EVE command: BOTTOM 

Press CTRL/G. 


She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Key defined 

Now define the GOLD CTRL/G key to enter the TOP command. Press the 
DO key, type DEFINE KEY, and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT | insert I Forward 

Command: DEFINE KEY 
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Type TOP and press RETURN. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

EVE Command: TOP 

Press the GOLD key (number 4 on the numeric keypad) and then press 
CTRL/G. 

She rhymes with tree, 

also with bee, 

and this one makes three. 

[End of file] 

Buffer RHYMES.DAT I Insert I Forward 

Key defined 

For the rest of your editing session, when you press CTRL/G, EVE executes 
the BOTTOM command; and when you press the GOLD key (number 4 on 
the numeric keypad) followed by CTRL/G, EVE executes the TOP command. 
If you press the GOLD key by mistake, press the Select key to cancel it. 

You can define only one GOLD key at a time. To remove a GOLD key 
definition, enter the SET NOGOLD KEY command, then press the key you 
want to undefine. Alternatively, define another GOLD key, which removes 
the original GOLD key definition. 

You can also define a GOLD key by inserting a command in an initialization 
file, using the following format: 

SET GOLD KEY keyname 

For example, the following command defines keypad key 4 as the GOLD key: 
SET GOLD KEY KP4 

To save key definitions from one editing session to the next, use the SAVE 
EXTENDED EVE command, described in Section 8.1.9.4. 


8.1.9.4 Saving Key Definitions and Learn Sequences 

The command definitions and learn sequences that you assign to keys extend 
the power of the EVE editor, making editing faster and more efficient. You 
can save your definitions cumulatively in a section file. EVE creates a section 
file automatically when you save definitions with the SAVE EXTENDED EVE 
command. Enter the SAVE EXTENDED EVE command before you terminate 
the editing session, using the following format: 

SAVE EXTENDED EVE filename 

The section file is saved in your current default directory unless you include 
a device and directory in the file specification. The file type defaults to 
TPU$SECTION. You can specify the same file specification each time you 
execute the SAVE EXTENDED EVE command. By doing this, you add any 
new key definitions and learn sequences to the same section file. 
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To use this extended version of EVE, you must include the /SECTION 
qualifier in the command line when you invoke EVE. For example, 
to invoke EVE to edit the file RHYMES.DAT using the section file 
WORKDISK:[USER]MYDEFS.TPU$SECTION, enter the following command: 

$ EDIT/TPU/SECTION=WORKDISK:[USER]MYDEFS.TPU$SECTION RHYMES.DAT 

Remember, you can define a command symbol to invoke this or any other 
lengthy command line. See the Guide to VMS Text Processing for further 
information on building section files. 


8.1.9.5 Creating Initialization Files 

Rather than defining keys or setting the characteristics of an editing 
session interactively, you can put EVE commands and key definitions in 
an initialization file. You can execute an initialization file when invoking EVE 
or during an editing session, by using the @ command; for example. 

Command: QSETUP.INIT 

An initialization file is an ASCII file containing standard EVE commands. 
When invoked, EVE executes an initialization file after the section file. 

Each command in an initialization file begins on a separate line. You 
can add comments to the file to document it, as long as you precede the 
comments with an exclamation mark and place them on a line separate from 
a command. An initialization file has a file type of EVE. The following is an 
example of an initialization file: 

set tabs every 5 

set left margin 15 

set right margin 75 

overstrike mode 

define key=Ctrl/D erase word 

define key=Gold/W start of line 

define key=KP5 fill paragraph 

j 

!Binds the EDT forward function (KP4 on 
!EDT keypad) to GOLD F 

j 

define key=Gold/F EDT KP4 

An initialization file can be specified with the /INITIALIZATION qualifier, 
defined as EVE$INIT in your LOGIN.COM file, or named EVE$INIT.EVE in 
your SYS$LOGIN directory. The following command invokes EVE with the 
initialization file named MY_INIT: 

$ EDIT/TPU/INIT=W0RK1:[ALEXIS]MY.INIT 

By default, EVE uses the initialization file whose logical name is EVE$INIT. 

If you define this logical name in your LOGIN.COM file, EVE automatically 
uses your initialization file when you invoke the editor. For example, you 
could insert the following command in your LOGIN.COM file: 

$ DEFINE EVE$INIT W0RK1:[ALEXIS]MY.INIT.EVE 

Since an initialization file is executed after a section file, the definitions in 
an initialization file override those in a section file. For this reason, place 
commands that define the editing environment in your initialization file. 
Commands that define the environment include the following: 
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• SET CURSOR BOUND or FREE 

• SET FIND WHITESPACE or NOWHITESPACE 

• SET KEYPAD 

• SET GOLD KEY 

• SET LEFT MARGIN 

• SET RIGHT MARGIN 

• SET SCROLL MARGINS 

• SET TABS AT or EVERY 

• SET TABS SPACES, MOVEMENT, or INSERT 

• SET TABS VISIBLE or INVISIBLE 

• SET WIDTH 

• SET WILDCARD VMS or ULTRIX 

• SET WRAP or NOWRAP 

• The default mode of the buffer: CHANGE MODE, OVERSTRIKE MODE, 
or INSERT MODE 

• The default direction of the buffer: CHANGE DIRECTION, FORWARD, 
or REVERSE 


8.1.10 Using the TPU Command 

EVE is an editor built on the VAX Text Processing Utility (VAXTPU), which 
is a programmable text processing utility. The TPU command allows you to 
enter any VAXTPU statement or series of statements that can be expressed on 
one command line. 

To enter a VAXTPU statement, press DO, enter the command TPU followed 
by the VAXTPU statement you want to execute, and press RETURN. For 
example, to execute the TPU APPEND—LINE statement, which places 
the current line at the end of the previous line, enter the command TPU 
APPEND_LINE. For more information on the TPU command, type HELP 
TPU. See the VAX Text Processing Utility Manual for a complete list of 
VAXTPU statements and procedures. 


8.1.11 Using DCL Within EVE 

You can execute a DCL command from within EVE, or you can use a 
subprocess to switch between the DCL command level and an EVE editing 
session very quickly. 
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8.1.11.1 Executing a DCL Command 

To execute a DCL command from within EVE, press the DO key, type the 
EVE command DCL and the DCL command you wish to execute, and press 
RETURN. The message Creating DCL subprocess .. . appears in the Message 
buffer. 

When the DCL command has executed, EVE creates another window, if 
necessary, and displays the DCL command and its output in the DCL buffer. 
(The cursor remains in the buffer it was in before you executed the DCL 
command.) You can move the cursor to the DCL buffer, select and remove 
text, and copy it to the editing buffer. Do not enter DCL commands that 
generate continuous output or run programs that do screen management of 
their own, such as the Phone Utility. The DCL command is most useful when 
you want to capture output in a buffer. 


8.1.11.2 Creating a Subprocess 

You can create a subprocess to switch between an EVE editing session and 
DCL command level without terminating your editing session. To create 
a subprocess, press the DO key, type the SPAWN command, and press 
RETURN. EVE suspends the current editing session and connects your 
terminal to a new VMS subprocess. The DCL prompt ($) appears on your 
screen. 

While the most common reasons to spawn a subprocess are to invoke the 
Mail Utility and to run screen-oriented programs, your subprocess can invoke 
any VMS utility or execute any DCL command. 

To return to your editing session, log out of the subprocess by typing the DCL 
command LOGOUT and pressing RETURN. EVE resumes the editing session, 
and the cursor appears in the location it occupied before you spawned the 
subprocess. 

You can also supply a DCL command as a parameter to the SPAWN 
command to create a specific subprocess. For example, to execute the Mail 
Utility, press DO, type SPAWN MAIL, and press RETURN. The prompt for 
the Mail Utility appears on the screen ( MAIL> ). When you exit from the 
Mail Utility, you are automatically logged out of the subprocess and EVE 
resumes the editing session. 


8.2 The EDT Editor 

EDT is an interactive text editor. With EDT you can create a new file, insert 
text into it, and modify that text. You can also edit text in existing files. 

EDT provides both line and keypad editing. In line editing, you type the 
editing command and the range of text you want the command to affect. In 
keypad editing, you move the cursor directly to the text you want to change 
and press keypad keys to enter the editing commands. 

An efficient way to use EDT on a video terminal is to use the keypad as the 
primary editing mode in combination with various line-editing commands. 
You can also redefine certain keypad and control keys to perform editing 
functions not available in keypad editing. This chapter describes keypad 
editing as the main editing mode and includes supplementary line-editing 
commands and key definitions. (If you are using a hardcopy terminal, you 
can use only line-editing commands.) 
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See the VAX EDT Reference Manual for a list of the line-editing commands 
available with EDT. 


8.2.1 Invoking and Terminating EDT 

An editing session begins when you invoke EDT with the DCL command 
EDIT. In an editing session, you can create and edit a new file, or you can 
edit an existing file. The session ends when you enter the EXIT or QUIT 
command. 


8.2.1.1 Invoking EDT 

To invoke EDT, type the DCL command EDIT and specify as a parameter 
the file you want to edit. If the specified file already exists, EDT saves the 
existing versions and places a copy of the latest version in your buffer. (A 
buffer is the temporary storage area in which you edit text.) The existing 
versions of the file remain unchanged. For example, to edit an existing file 
named MEMO.TXT, enter the following command line: 

$ EDIT MEMO.TXT 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The first few lines of the latest version of the file appear on the screen. The 
cursor is positioned at the top of the screen, and EDT is ready to receive a 
keypad-editing command. 

If you invoke EDT to create a file, the following message appears: 

$ EDIT NEWFILE.TXT 

[EOB] 


Input file does not exist 

Only the EDT message and the end-of-buffer symbol, [EOB], appear on the 
screen, and EDT is ready to receive keypad-editing commands. See Section 
8.2.2.1 for a description of EDT line commands. 

Note: In the previous examples, you enter EDT in keypad (change) mode 

because a startup command file (SYS$LOGIN:EDTINI.EDT) containing the 
SET MODE CHANGE command has been executed. If this command is 
not executed in an EDT startup command file, you will enter EDT in line 
mode. See Section 8.2.7.1 for more information on EDT startup command 
files. 
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8.2.1.2 Terminating EDT 

To terminate an EDT session, press CTRL/Z. This puts you into line¬ 
editing mode. You can type EXIT or QUIT at the asterisk (*) prompt. QUIT 
terminates the editing session and does not save your edits. EXIT saves your 
edits in a new version of the file. (Note that the existing versions of a file 
remain unchanged regardless of how the editing session is terminated.) 

To save your edited text, use the line-editing command EXIT to terminate 
EDT. When you enter the EXIT command, EDT creates an output file 
containing the edited version of the input file. By default, the output file 
has the same name and type as the input file, with the version number 
incremented by 1. 

For example, if you enter the EXIT command after editing a file named 
MEMO.TXT;3, EDT creates a higher version named MEMO.TXT;4 as follows: 

* EXIT 

DISKI: [USER]MEMO.TXT;4 2 lines 

$ 

To override the default output file name, enter the EXIT command with a 
new file specification as the parameter. For example, if you end the same 
editing session with EXIT MICE.TXT, EDT names the output file MICE.TXT; 1, 
provided no other file named MICE.TXT exists. 

♦EXIT MICE.TXT 

DISKI:[USER]MICE.TXT;1 2 lines 

$ 

To terminate EDT without saving your edits, use the line-editing command 
QUIT. All edits you have made to the text are ignored, and no output file is 
created. 

♦ QUIT 

$ 

The QUIT command is a useful way to terminate EDT when you have opened 
a file by mistake. No new file version is created. 


8.2.2 Entering EDT Commands 

Enter most keypad-editing commands by pressing a keypad key. Enter line¬ 
editing commands by typing them after the line-editing prompt and pressing 
RETURN. o r r r e 

8.2.2.1 Entering EDT Line Commands 

EDT prompts for line-editing commands with an asterisk. Line-editing 
commands usually operate on a range of one or more lines of text that you 
specify as a parameter for the command. For example, to display an entire 
file on your screen, enter the TYPE command and specify WHOLE as the 
parameter as follows: 

♦TYPE WHOLE 

You can abbreviate EDT line-editing commands. For clarity, the examples in 
this chapter show complete line-editing commands. 
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8.2.2.2 Entering Keypad Commands 

In keypad editing, the screen displays editing changes as you make them. 
You type text from the main keyboard and enter keypad-editing commands 
from the numeric keypad. (To initiate keypad editing, you must first enter the 
line-editing command CHANGE or have SET MODE CHANGE in your EDT 
startup file. See Section 8.2A.2 for information on the CHANGE command.) 

The following figure shows the keypad keys and their functions. 
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Each key in the keypad performs at least one editing command; most perform 
two. Pressing a key invokes the regular, or upper, function. To invoke the 
alternate, or lower, function of a key, press the GOLD key (labeled PF1) first, 
followed by the desired key. In the examples that follow, a small diagram 
of the keypad highlights the key or keys that perform the command being 
described. The text associated with the keypad illustrates the effect of that 
editing command. 

For example, key 1 performs both the WORD and the CHNGCASE functions. 
To invoke the WORD command, press WORD: the cursor moves to the 
beginning of the next word. 
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WORD 


□□□ 


□□□ 


□□□ 




□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

To invoke the CHNGCASE command, press the GOLD key first and then 
CHNGCASE. The character at the cursor or the characters highlighted with 
the select key changes from lowercase to uppercase or from uppercase to 
lowercase. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

CHNGCASE 




□□□ 


□□□ 




□n 



Once The weather turns cold, mice may find a crack in your foundation 
and enter your house. They're looking for food and shelter from the harsh 
weather ahead. 

[EOB] 

The supplemental editing keys on the VT200 keypad perform the same 
functions as some of the EDT keypad keys. (See the VAX EDT Reference 
Manual for more information about these supplemental editing keys.) 
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Help 


(Enter) 

Do 


Find 

(Paste) 

Insert 

Here 

(Cut) 

Re¬ 

move 

Select 

Prev 

Screen 

Next 

Screen 


ZK-1677-84 


8.2.2.3 Canceling EDT Commands 

Use CTRL/C to cancel the currently executing EDT command without 
affecting previous edits. For example, to stop the display of a long file, press 
CTRL/C. 

♦TYPE WHOLE 


1CTRL/cj 

Icancel! 

Aborted by CTRL/C 
* 

The display stops and the CTRL/C message appears. 


8.2.3 Getting HELP in EDT 

EDT provides a help facility for each of the EDT editing modes. 

8.2.3.1 Getting HELP on Keypad-Editing Commands 

To display a diagram of the keypad keys and their functions, enter change 
mode (assuming you are in line-editing mode) and then press the HELP key 
(labeled PF2). (On VT200-series terminals, you can also use the HELP key on 
the supplemental editing keypad.) To display information about a particular 
keypad command, first press the HELP key and then press the keypad key. 
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8.2.3.2 Getting HELP on Line-Editing Commands 

To display a list of EDT topics on which information is available, type HELP 
and press RETURN. To display information about a particular command or 
topic, type HELP followed by the name of the topic and press RETURN. EDT 
responds with a display of information about the topic and a list of related 
topics about which information is available. To display information about the 
use of a particular command qualifier, type HELP plus the command and that 
qualifier and press RETURN. For example, to display information on the use 
of /QUERY with the COPY command, enter the following command line: 

♦HELP COPY /QUERY 


8.2.3.3 Getting HELP on Nokeypad-Editing Commands 

Nokeypad commands are used to construct key definitions. To display a list 
of the nokeypad-editing commands on which information is available, enter 
the following HELP command in line mode: 

♦HELP CHANGE SUBCOMMANDS 

To display information about nokeypad entities (units of text upon which 
nokeypad-editing commands operate), enter the following HELP command in 
line mode: 

♦HELP CHANGE ENTITIES 


8.2.4 Changing Editing Modes 

You can easily switch back and forth between line and keypad editing; 
you can also enter line-editing commands from keypad mode. Before using 
keypad commands, be sure that your terminal type is set properly. (Use 
SHOW TERMINAL to display the setting and SET TERMINAL/INQUIRE to 
set the terminal type.) 


8.2.4.1 Changing from Keypad to Line Editing 

To change from keypad editing to line editing, press CTRL/Z. The asterisk 
prompt appears at the bottom of your screen, indicating EDT is ready to 
accept line-editing commands. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

fCTRL/Zl 


8.2.4.2 Changing from Line to Keypad Editing 

To change from line editing to keypad editing, enter the CHANGE command: 

♦CHANGE 

The first 22 lines of the file are displayed on your screen. If the file has fewer 
than 22 lines, the [EOB] symbol appears below the last line of the file. 
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8.2.4.3 Entering Line-Editing Commands from Keypad Mode 

The keypad COMMAND function allows you to enter line-editing commands 
without leaving keypad mode. First, enter COMMAND (by pressing GOLD 
and then COMMAND) to invoke the Command: prompt, then type the line¬ 
editing command and press ENTER. (If you press RETURN by mistake, M 
appears; delete the 'M by pressing the DELETE key on the main keyboard, 
and press ENTER.) The following example enters the line-editing command 
SET QUIET, which suppresses the sound made when EDT issues an error 
message: 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


COMMAND 






□□□ 


□□□ 


i—in 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

Command: SET QUIET 

t 

ENTER 

□□□□ 

□□□□ 

□□□□ 


8.2.5 Recovering from Interruptions 

You can recover from interruptions to your editing session in the following 

ways: 

• Deleting extraneous characters—Pressing CTRL/W removes extraneous 
characters (such as a broadcast message or a message indicating that you 
have received electronic mail) from the screen and restores the previous 
display. Use CTRL/W to ensure that the cursor is in the correct position. 

• Resuming an interrupted editing session—The DCL command 
CONTINUE resumes an editing session that was interrupted by pressing 
CTRL/Y, so long as only built-in DCL commands were entered after 
pressing CTRL/Y. (See Chapter 1 for a list of built-in commands.) For 
example, you could press CTRL/Y, enter the command SHOW TIME, 
and return to your editing session with the CONTINUE command. 
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(Press CTRL/W to refresh the screen display. The text of your editing 
session is once again displayed.) 

• Recovering a lost session—By default, EDT keeps a journal file with the 
same file name as the input file and a file type of JOU. If the editing 
session ends without interruption, the journal file is deleted when you 
terminate the session. If the editing session is aborted (for example, 
during a system failure, in response to pressing CTRL/Y, or entering the 
QUIT/SAVE command), you can recover your edits (with the exception 
of those commands entered just prior to the interruption). Enter the 
same command line you used to begin the editing session, adding the 
/RECOVER qualifier. For example: 

$ EDIT/RECOVER MEMO.TXT 

EDT will reproduce the editing session, reading the commands from the 
journal file and executing them on the screen. 


8.2.6 EDT Keypad Editing 

While line editing allows you to manipulate large portions of text easily, 
keypad editing provides easy manipulation of small units of text. Several 
EDT keypad commands enable you to find, insert, delete, substitute, and 
move text in a file. The cursor can be moved through a file in a variety of 
ways, and the position of the cursor in a file determines how text will be 
affected by EDT commands. 


8.2.6.1 Manipulating the Cursor 

You can manipulate the cursor with commands that move it unit by unit 
through the text or with commands that move it directly to a particular 
location. Several commands that move the cursor are controlled by the 
ADVANCE and BACKUP commands, which set the cursor's direction forward 
and backward. Unless otherwise stated, this chapter assumes the default 
direction of the cursor to be ADVANCE. 

You can move the cursor by character, word, and line units. 

Use one of the following keys to move the cursor by character: 

• RIGHT ARROW — Moves the cursor one character to the right. 

• LEFT ARROW — Moves the cursor one character to the left. 

• CHAR — Moves the cursor one character in the current direction. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


CHAR 


□□□ 


□□□ 


□□□ 




i in 
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Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead 
[EOB] 

The WORD command moves the cursor to the beginning of the next or 
previous word. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


WORD 


□□□ 


□□□ 


□□□ 




□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The following keys move the cursor by line: 

• UP ARROW—Moves the cursor up one line. 

• DOWN ARROW—Moves the cursor down one line. 

• EOL—Moves the cursor to the end of the current or previous line. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


EOL 


□□□ 


□□□ 


□□□ 




□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

• F12 (the BACKSPACE key on VTlOO-series terminals)—Moves the cursor 

to the beginning of the previous line. 
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Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. IF12I ( | backspace! ) 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

• LINE—Moves the cursor to the beginning of the next line or previous 

line. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 


LINE 


□□□ 


□□□ 


□□□ 


□□□ 


BD 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The OPEN LINE command terminates a line without moving the cursor. (The 
RETURN key also terminates a line, but moves the cursor to the next line.) 
The OPEN LINE command is useful when you want to insert a blank line or 
a new line of text. When the cursor is placed at the beginning of a line and 
the OPEN LINE command is entered, the text on that line is moved down so 
that the cursor is at the beginning of a blank line as follows: 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


OPEN LINE 




□□□ 


□□□ 


□□□ 


■ 



Once the weather turns cold, mice may find a crack in your 

foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

To move the cursor by large units, use the SECT and PAGE commands. The 
SECT and PAGE commands allow you to scan several lines of text at a time. 
The direction in which EDT moves depends upon whether ADVANCE or 
BACKUP is set. 
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• SECT—Moves the cursor across a 16-line section of text in EDT's current 
direction. If there are fewer than 16 lines, SECT moves the cursor across 
the existing lines. 

(On the VT200-series terminals, the supplemental editing keypad key 
Next Screen moves the cursor 16 lines forward, regardless of EDT's 
current direction. The supplemental editing keypad key Prev Screen 
moves the cursor 16 lines backward, regardless of EDT's current 
direction.) 

• PAGE—Moves the cursor to the next or previous page boundary (form 
feed) or to the end or top of the buffer if there is no boundary. To insert 
form feeds in your text, use CTRL/L. 

The TOP and BOTTOM commands allow you to move directly to the 
beginning or end of a buffer. (See Section 8.2.6.8 for more information 
about buffers.) 

• TOP—Moves the cursor to the beginning, or top, of the buffer. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


TOP 




□□□ 




□□□ 


□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

• BOTTOM—Moves the cursor to the end, or bottom, of the buffer. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


BOTTOM 




□□□ 




□□□ 


□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 
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The ADVANCE and BACKUP commands control the cursor's direction for the 
following EDT keypad-editing commands: CHAR, CHNGCASE, EOL, FIND, 
FNDNXT, LINE, PAGE, SECT, SUBS, and WORD. Each of the directional 
commands remains in effect until you set the cursor in the opposite direction 
with the other command. 

• ADVANCE—Sets the cursor's direction forward so that subsequent 

commands move the cursor in the forward direction. For example, if you 
enter the WORD command after using ADVANCE, the cursor moves 
forward one word. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


ADVANCE 


□□□ 


□□□ 




□□□ 


□□ 



WORD 


□□□ 


□□□ 


□□□ 




□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

• BACKUP—Sets the cursor's direction in the backward direction so that 
subsequent commands move the cursor toward the top of the buffer. For 
example, if you enter the WORD command after using BACKUP, the 
cursor moves backward one word. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


BACKUP 


□□□ 


□□□ 




□□□ 


□□ 
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WORD 


□□□ 


□□□ 


□□□ 




□□ 



Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The cursor remains set in the backward direction until you press ADVANCE. 
For example, if you enter a second WORD command in the preceding 
example you receive a message indicating that the command requests EDT to 
back up past the top of the buffer. 

The ADVANCE and BACKUP commands are particularly important in string 
searches; see Section 8.2.6.4 for more information on searches. 


8.2.6.2 Inserting Text 

To insert text in EDT keypad editing, position the cursor where you want 
the text to be inserted and begin typing; the cursor remains one position to 
the right of the last character inserted. Inserting text in the middle of a line 
moves both the cursor and the remainder of the line one position to the right 
for each character inserted. When the line exceeds 80 characters, the text 
you type will either wrap to the following line or disappear off your screen, 
depending on the status of the SET SCREEN, SET [NOJTRUNCATE, and SET 
[NO]WRAP commands. (See Section 8.2.7.2 for information about screen 
formatting commands.) 

8.2.6.3 Deleting and Restoring Text 

The delete commands work like the cursor movement commands. In EDT 
keypad editing, you can delete by character using the Delete key (O ) 
(DELETE on VT100-series terminals) and DEL C; by word using FI 3 
(LINEFEED on VTlOO-series terminals) and DEL W; and by line using DEL L, 
DEL EOL, and CTRL/U. 

The deleted text is stored in a buffer so that you can also restore the character 
(UND C), word (UND W), or line (UND L) most recently deleted wherever 
and as many times as you need. Note that the undelete commands restore 
only the corresponding units of text that were most recently deleted. For 
example, if you have deleted two lines of text with the DEL L (delete line) 
command, the UND L (undelete line) command will restore only one line, the 
line most recently deleted. 

The <2 key on the main keyboard (the DELETE key on VTlOO-series 
terminals) deletes the character immediately to the left of the cursor. The 
EDT keypad-editing command DEL C deletes the character directly at the 
cursor. The UND C command restores the last character deleted with either 
the <~xl (DELETE) key or the DEL C command. For example: 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 
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DEL C 

□□□□ 

□□□□ 

□□□■ 

□□□n 

□□u 


nee the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

UNDC 

■□□□ 

□□□□ 

□□□■ 

□□u 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The F13 key on the main keyboard (the LINEFEED key on VTlOO-series 
terminals) deletes to the beginning of the current or preceding word. The 
DEL W command deletes to the end of the current word. Blank spaces are 
considered part of the word they follow, while all other word delimiters are 
considered to be separate words. The UND W command restores the last 
word deleted with either the FI3 (LINEFEED) key or the DEL W command. 
For example: 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


DEL W 


□□□□ 

□□□1 

■ 

□□□ 


□□□ 


□□ 



Once the weather turns cold, may find a crack in your 
foundation and enter your house. They're looking for food 
and shelter from the harsh weather ahead. 

[EOB] 
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UND W 


■□□□ 

□□□1 

■ 

□□□ 


□□□ 


□□ 



Once the weather turns cold, mice may find a crack in your 

foundation and enter your house. They're looking for food and 

shelter from the harsh weather ahead. 

[EOB] 

The following commands delete a line (or part of a line) of text: 

• DEL L—Deletes from the cursor to the end of the line, including the line 
terminator. If the cursor is at the beginning of the line, the entire line is 
deleted, and the cursor is positioned at the beginning of the next line. 

• DEL EOL—Deletes from the cursor to the end of the line (excluding the 
line terminator), leaving the cursor at the end of the truncated line. 

• CTRL/U—Deletes from the cursor to the next previous beginning of line, 
leaving the cursor at the beginning of the previous line. (If CTRL/U is 
used when the cursor is at the beginning of the line, the previous line is 
deleted.) 


The UND L command restores the last line (or part of a line ) that was deleted 
with the DEL L, DEL EOL, or CTRL/U command. For example: 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

DELL 

□□□■ 


□□□ 


□□□ 


□□□ 


□□ 



Once the weather foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 


UND L 


□□□ 


□□□ 


□□□ 


on 



8-61 




















Editing Files with the EVE and EDT Editors 

8.2 The EDT Editor 


Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. 

[EOB] 

The EDT line-editing command DELETE is useful for deleting large sections 
of text. Generally, you use line numbers to specify a range for a line-editing 
command. For example, to delete lines 306 through 860, enter the following: 

* DELETE 306 THRU 860 

555 lines deleted 

861 Rodents have had a profound effect on human civilization. 

* 

Note that the EDT line-editing command SET NUMBERS (the default) must 
be in effect for line numbers to be displayed in EDT line editing. 

You can also use certain keywords (such as WHOLE, REST, BEFORE) as 
range specifiers. For example, if you are in the middle of a long buffer and 
want to delete from the cursor to the end of the buffer, enter the following: 

♦DELETE REST 
43 lines deleted 
[EOB] 

* 

(You can also specify range by using the EDT keypad-editing command 
SELECT. See Section 8.2.6.7 for information on SELECT.) 


8.2.6.4 Locating Text 

You can move the cursor to a character string you specify with the FIND and 
FNDNXT EDT keypad-editing commands. The FIND command searches for 
the specified character string between the current position of the cursor and 
the beginning or end of the buffer (depending on whether the ADVANCE 
or the BACKUP command is in control). EDT does not distinguish between 
uppercase and lowercase letters unless you use the SET SEARCH EXACT 
line-editing command. When EDT finds the string, it positions the cursor at 
the first character in the string (unless the SET SEARCH END command is 
in effect, and the cursor is positioned at the last character in the string). In a 
long file the message "Working" may flash on the screen while EDT searches 
for the string. 

For example, to delete a comma after the word "house" in the following text, 
you can use the FIND command to move the cursor to the string "house." 
First, enter the EDT keypad command FIND by pressing the GOLD key and 
then the FIND key (on the VT200-series terminal you can also use the FIND 
key located on the supplemental editing keypad). Next, type the string you 
want to locate (the search string) after the Search for: prompt. 


FIND 




□□□ 


□□□ 


□□□ 


□□ 
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Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. Once inside, they may gnaw 
through electrical wires and raid your food. Because mice reproduce 
so quickly, what started as one or two mice can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 

Search for: house 

To search in the forward direction, use the ADVANCE command to enter the 
search string. 


ADVANCE 


□□□ 


□□□ 




□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. Because elephants reproduce so 
quickly, what started as one or two elephants can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 

Use the CHAR command to move the cursor to the comma after the word 
"house". Then use the DEL C command to delete the comma. 


CHAR 


□□□ 


□□□ 


□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. Because elephants reproduce so 
quickly, what started as one or two elephants can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 

To find the next occurrence of the string located with the FIND command, 
use the FNDNXT (find next) command. If there is no other occurrence of 
the string (as in the example above), EDT issues the message "String was not 
found." 

Note: Note that the directional setting of the cursor determines the direction 
of the search. After you press FIND, you can press either ADVANCE or 
BACKUP (depending on the direction in which you want to search) to 
enter the search string. You can also use the ENTER command, which 
applies the current direction to the search. 
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8.2.6.5 Substituting Text 

To substitute one character string for another, you can use the SUBS keypad¬ 
editing command or the SUBSTITUTE line-editing command. The EDT 
line-editing command can make global substitutions; that is, it can replace 
every occurrence of one character string in the specified range with another 
string using only one EDT line-editing command. In contrast, you must use 
the keypad SUBS command (press the GOLD key followed by the SUBS 
key) for each substitution you make. (If you do not specify a range, the 
line-editing command SUBSTITUTE replaces only the first occurrence of the 
search string in the current line with the substitute string.) 

For example, to substitute the string "mice" for "elephants" throughout a 
buffer, enter the line-editing command SUBSTITUTE, the old string, and the 
new string, separating all three with the same delimiter. You can use any 
nonalphanumeric character (except the percent sign and underscore) as a 
delimiter for the SUBSTITUTE command, as long as the delimiting character 
is not part of either string. To apply the command to the entire buffer in a 
global substitution, specify WHOLE as the parameter. When the operation 
has been completed, EDT displays each occurrence of the substitution and the 
total number of substitutions. The following example substitutes the string 
"mice" for each occurrence of the string "elephants" in the following text: 

COMMAND 






□□□ 


□□□ 

□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. Because elephants reproduce so 
quickly, what started as one or two elephants can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 

Command: SUBSTITUTE\mice\e1ephant s\WH0LE 

ENTER 


□□□□ 

□□□□ 

□□□□ 



1 Once the weather turns cold, elephants may find a crack 

4 in your electrical wires and raid your food. Because elephants reproduce 

5 so quickly, what started as one or two elephants can quickly become an 
3 substitutions 

Press return to continue 
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Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. Because elephants reproduce so 
quickly, what started as one or two elephants can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 

Note that a global substitution replaces all occurrences of the string, regardless 
of case or surrounding characters. If you want EDT to search for exact 
comparisons of case, use the SET SEARCH EXACT command. If the search 
string occurs in the middle of a longer string, the substitution will still be 
made. For instance, a global substitution of "IN" for "AT" would change all 
words containing the string "AT". ("LATER" would become "LINER", "THAT" 
would become "THIN", "SAT" would become "SIN", and so on.) 

To get EDT to prompt you before each substitution, use the /QUERY qualifier 
with the SUBSTITUTE command. 

Command: SUBSTITUTE\AT\IN\WHOLE/QUEEY 

EDT prompts you with a ? to verify each substitution. You can respond with 
one of the following: 

Y Yes, do the substitution. 

N No, do not do the substitution. 

Q Quit, terminate the command. 

A All, do the rest of the substitutions without query. 


8.2.6.6 Moving Text 

Both EDT keypad and line commands can move text; however, only line¬ 
editing commands transfer text between buffers and files. 


8.2.6.7 Moving Text Within the File 

The EDT keypad-editing command CUT deletes a selected range of text 
and the PASTE command inserts it at the cursor's current position. (On the 
VT200-series terminals, the supplemental editing keys Remove and Insert 
Here perform the same functions as the EDT keypad commands CUT and 
PASTE.) For instance, to move the first sentence in the second paragraph of 
the example to the end of that paragraph, move the cursor to the beginning 
of the sentence and press SELECT. (On the VT200-series terminals, the 
supplemental editing key SELECT performs the same function as the EDT 
keypad command SELECT.) This marks the beginning of the selected range. 
(You can cancel the SELECT command with the RESET command.) 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. Once inside, they may gnaw 
through electrical wires and raid your food. Because mice reproduce 
so quickly, what started as one or two mice can quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent these rodents from ever getting in. 

[EOB] 
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SELECT 

□□□ 

□□□ 

□□□ 

□□□ 

□1 

To mark the end of the selected range, move the cursor to the end of the 
sentence. The terminal highlights a selected range in reverse video. (The 
selected range includes the text up to the character preceding the cursor.) 

Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. Because elephants reproduce so 
quickly, what started as one or two elephants can quickly become an 


house, you 

[EOB] 


Press CUT 

CUT 


□□□ 

— 

□□□ 




□□□ 


LJU 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. 

[EOB] 

Deleted text remains in the PASTE buffer until you perform another CUT 
operation. To restore the text, move the cursor to the appropriate position 
and enter the PASTE command. (The text will be inserted directly in front of 
the cursor.) 

Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. 

[EOB] 


8-66 













Editing Files with the EVE and EDT Editors 

8.2 The EDT Editor 


PASTE 




□□□ 




□□□ 


on 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 

[EOB] 

Because the selected text is held in the PASTE buffer until you perforin 
another CUT operation (or give the line-editing command CLEAR PASTE), 
you can paste the text contained in the PASTE buffer as many times as you 
want. You can also enter the PASTE buffer to edit the text it contains. (See 
Section 8.2.6.8 for information on using multiple buffers.) 

After moving the text, you may want to use the FILL command to reorganize 
selected text so that the maximum number of whole words are fitted within 
the current line width. The default line width is 80 characters, but you can 
use the SET WRAP command to use another line length for filling text. 

For example, you can set the line length to 71 characters with the EDT 
line-editing command SET WRAP and then fill a selected range of text. 

COMMAND 






□□□ 


□□□ 


on 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 

[EOB] 

Command: SET WRAP 71 

ENTER 


□□□□ 

□□□□ 

□□□□ 
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Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 

[EOB] 

EDT will now wrap lines of inserted text and fill lines of selected text at a line 
width of 71 characters. Use the SELECT command to mark the text you want 
to affect and then enter the EDT keypad command FILL. 

SELECT 

□□□□ 

□□□□ 

□□□□ 

□□□n 

niu 

Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as 
one or two elephants can quickly become an invasion. 

[EOB] 


FILL 






□□□ 


□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 

[EOB] 

There are several EDT line-editing commands that move text. For example, 
the MOVE and COPY commands each perform a function similar to those of 
the keypad CUT and PASTE operations. MOVE deletes text from one location 
and inserts it in another; COPY inserts a copy of the text where specified 
without deleting any text. The EDT line-editing commands INCLUDE and 
WRITE perform tasks not possible with EDT keypad-editing commands: 

• INCLUDE—Copies a file into the buffer you are currently editing or the 

buffer you specify. Follow the VMS conventions for file specifications 
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when specifying the file to be copied to the buffer. For example, the 
following command copies the file named MEM.DAT to the buffer named 
BUF1: 

Command: INCLUDE MEM.DAT =BUF1 

• WRITE—Copies a specified range of text from a buffer (the current buffer 
by default) to a specified file. If you do not specify a range, the WRITE 
command copies the entire contents of the current buffer. For example, 
the following command copies the contents of the current buffer to the 
file ANIMALS.TXT: 

Command: WRITE ANIMALS.TXT 

$DISK1:[USER]ANIMALS.TXT;1 11 lines 

The message displays the new file specification and length. 


8.2.6.8 Using Multiple Buffers 

When you begin editing a file with EDT, you are working on a copy of the 
file in a buffer called MAIN. (EDT also uses a buffer called PASTE to store 
the text that you delete with the CUT and APPEND commands; you can 
edit this buffer just as you can edit other text buffers.) You can create other 
buffers to store pieces of text during your EDT editing session. You can enter 
and edit these buffers; you can copy text to and from them; and you can write 
their contents to specified files. 

To create a buffer, press the COMMAND key. Type the line-editing 
command FIND followed by the equal sign and the name you are giving 
the buffer, then press the ENTER key. For example, the following command 
creates a buffer named BUF1: 

COMMAND 






□□□ 


□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 

[EOB] 

Command: FIND=BUF1 

When you enter this command, the system responds by displaying only the 
[EOB] symbol, which indicates that the current buffer, BUF1, is empty. You 
can now insert and edit text just as you would in the MAIN buffer. To return 
to the MAIN buffer, follow the same procedure, typing FIND=MAIN rather 
than FIND=BUF1. To return to your previous position in the MAIN buffer, 
include a period after the buffer's name as follows: 

Command: FIND=MAIN, 
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The buffer named BUF1 remains intact until you exit from EDT, regardless of 
whether you enter the EXIT or QUIT command. That is, you can enter, edit, 
and exit from a buffer as necessary. However, when you exit from EDT, only 
the buffer MAIN is saved. 

The SHOW BUFFER command displays the number of lines contained in each 
buffer and indicates (with an equal sign) the current buffer. The following 
example indicates that there are three buffers (including MAIN and PASTE, 
which always exist) and that MAIN is the current buffer: 

COMMAND 



_ 



□□□ 


□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 


[EOB] 

Command: SHOW BUFFER 

=MAIN 11 lines 

PASTE 3 lines 

BUF1 2 lines 

Press return to continue 

Pressing the RETURN key returns the cursor to its previous position in the 
buffer. 

You can further manipulate the contents of a buffer by specifying the buffer's 
name in an EDT line-editing command. For example, if you are in the MAIN 
buffer and want to save the contents of BUF1 in a file named RODENT.TXT 
before exiting from EDT, enter the following command: 

COMMAND 






□□□ 


□□□ 


□□ 



Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and shelter 
from the harsh weather ahead. Once inside, they may gnaw through 
electrical wires and raid your food. If you seal the cracks and holes 
on the exterior of your house, you can prevent these rodents from ever 
getting in. Because elephants reproduce so quickly, what started as one 
or two elephants can quickly become an invasion. 
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[EOB] 

Command: WRITE RODENT.TXT =BUF1 

SDISK1:[USER]RODENT.TXT;1 2 lines 

EDT returns a message indicating that the file has been created, and the 
cursor is returned to its previous location in the buffer. 


8.2.7 Controlling EDT Sessions 

You can control some of the characteristics of an EDT editing session with the 
SET commands. You can redefine the functions of many keys by using the 
EDT line-editing command DEFINE KEY (or CTRL/K in keypad editing) 
plus one or more EDT nokeypad-editing commands. (EDT nokeypad¬ 
editing commands perform keypad operations; you can combine them in 
key definitions to extend your editing capacity. See the VAX EDT Reference 
Manual for a list of EDT nokeypad-editing commands.) You can also define 
a macro (a sequence of line-editing commands) and define keys in EDT. You 
can enter these control commands interactively, or you can include them in 
an EDT startup command file. 


8.2.7.1 Startup Command Files 

An EDT startup command file contains EDT line-editing commands that are 
executed when you invoke EDT before you receive control of the editor. A 
startup command file is useful for setup operations in EDT; it can include 
specifications for screen format, definitions of text entities, and definitions of 
keys and macros. Generally, EDT reads a systemwide startup command file 
at the beginning of your editing session. If no systemwide startup command 
file exists on your system, EDT looks for a file named EDTINI.EDT in your 
default directory and processes the commands in that file. 

To create an EDTINI.EDT file, invoke an editor and specify EDTINI.EDT as 
the file specification as follows: 

$ EDIT EDTINI.EDT 

Now list the commands, one per line. Some typical commands you might 
want to put in a startup command file follow: 

SET QUIET 
SET WRAP 60 
SET SEARCH BOUNDED 
SET TAB 5 

DEFINE KEY GOLD P AS "PAR." 

SET MODE CHANGE 

When you exit from the editor, EDTINI.EDT is saved in your default 
directory. Every time you invoke the editor, the commands in your 
EDTINI.EDT file are in effect. 

To specify an EDT startup command file named something other than 
EDTINI.EDT, you must include the file specification in the EDIT command 
line n as follows: 


$ EDIT/COMMAND=startup-file-spec file-spec 

For a list of EDT line and nokeypad editing commands, see the VAX EDT 
Reference Manual. 
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8.2.7.2 Controlling Screen Format with SET Commands 

Several EDT commands control the format of a screen display. Some are 
listed below. See the VAX EDT Reference Manual for a comprehensive list of 
the SET commands. 

• SET LINES n—Controls the number of lines that EDT displays on the 
screen. This number, which can be set from 1 to 22, defaults to 22. To 
set the screen to 15 lines, for example, type: 

Command: SET LINES 15 | 

Note that if you are editing at slow baud rates, setting the number of 
lines low will increase your editing speed. 

• SET SCREEN width—Controls the maximum length of the line EDT 
displays; the default width is 80 characters. (When there are more 
characters than the SET SCREEN command specifies, EDT displays a 
diamond at the end of the line.) 

Command: SET SCREEN 132 | 

If you use the SET SCREEN command to make the screen wider than 80 
on either a VT100- or VT200-series terminal, EDT changes the terminal's 
screen width to 132. 

• SET [NOJTRUNCATE—Controls whether the characters that exceed 
the SET SCREEN width are displayed on the next line. The default is 
SET TRUNCATE, which ends the display of a line at the value of SET 
SCREEN. 

Command: SET [NO]TRUNCATE 

• SET [NOJWRAP n—Specifies n character positions as the point at 
which text will be moved to the beginning of the next line. When 
you are inserting text in EDT keypad mode and the cursor position 
exceeds the value of n, EDT wraps the next full word to the next line. 
(However, when you insert text in the middle of a line, that line does not 
always wrap.) The default is NOWRAP. To wrap the text exceeding 75 
characters, for example, type: 

Command: SET WRAP 75 

SET commands have corresponding SHOW commands; see the VAX EDT 
Reference Manual for a list of SHOW commands. 


8.2.7.3 Controlling Editing Functions with SET Commands 

Several commands control EDT's responses during an editing session, as 
follows. (See the VAX EDT Reference Manual for a comprehensive list of the 
SET commands.) 

• SET ENTITY—Defines boundaries for the WORD, SENTENCE, 

PARAGRAPH, and PAGE entities. (The SENTENCE and PARAGRAPH 
entities are not used by any default key definitions; consequently, they 
are useful only in the key definitions you create with the DEFINE KEY 
command.) For example, the default boundaries for the WORD entity are 
a line feed, tab, form feed, line terminator, and space. To make the period 
and comma the only delimiters of the word entity, enter the following 
SET ENTITY command: 

Command: SET ENTITY WORD *,. 1 
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• SET MODE—Controls the EDT editing mode to be entered when the 
processing of the EDTINI.EDT file is completed (either line or change 
mode, which is keypad mode). For example, to enter change mode 
instead of line mode at the beginning of editing sessions, insert the 
following command at the end of your EDT startup command file: 

SET MODE CHANGE 

• SET QUIET—Suppresses the sound made when EDT issues an error 
message in keypad mode. The default is NOQUIET. 


8.2.7.4 Defining Keys 

To redefine a key, assign one or more EDT nokeypad-editing commands 
(listed in the VAX EDT Reference Manual) to the key with the DEFINE KEY 
command: 

Command: DEFINE KEY key AS "command(s)" 

You can redefine all keypad keys. You can define any GOLD keyboard 
key sequence except the keyboard digits, minus sign, and O key (the 
DELETE key on VTlOO-series terminals). See the VAX EDT Reference Manual 
for a diagram of the keypad key numbers you use to define keypad keys. 
Although you can define many keys as control keys, do not redefine the 
specialized control keys CTRL/C, CTRL/M, CTRL/O, CTRL/P, CTRL/Q, 
CTRL/R, CTRL/S, CTRL/T, CTRL/U, CTRL/Y, and CTRL/Z. 

The following example of a key definition redefines the GOLD key and the 
S key combination to perform a global substitution, with prompts for the 
search string and the replacement string: 

♦DEFINE KEY GOLD S AS "EXT S/?*'REPLACE: '/?*' WITH: '/WHOLE." 

The string within quotation marks consists of an EDT line-editing command 
(EXT, which tells EDT that the rest of the line is an EDT line-editing 
command); an EDT line-editing command (SUBSTITUTE, abbreviated 
"S"); its qualifier (WHOLE); prompts (the question marks followed by the 
prompts REPLACE and WITH, and the asterisk (*) directly following the 
question mark prompt, allowing you to use either ENTER or RETURN to 
enter your response). Note that the period at the end of the definition 
(before the final quotation mark) is necessary to make the command execute 
immediately when the key is pressed. Subsequent use of GOLD S performs 
the substitution, prompting for old and new strings and displaying the 
substitutions. 

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. Once inside, they may gnaw 
through electrical wires and raid your food. Because mice reproduce 
so quickly, what started as one or two mice could quickly become an 
invasion. If you seal the cracks and holes on the exterior of your 
house, you can prevent the rodents from ever getting in. 

[EOB] 

I GOLD 1 + |D[ __ 

REPLACE: mice 1 enter] WITH: elephants 1 ENTER! 

Once the weather turns cold, elephants may find a crack in your 
foundation and enter your house. They're looking for food and 
shelter from the harsh weather ahead. Once inside, they may gnaw 
through electrical wires and raid your food. Because elephants 
reproduce so quickly, what started as one or two elephants could 
quickly become an invasion. If you seal the cracks and holes on the 
exterior of your house, you can prevent the rodents from ever getting in. 
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Placing key definitions (such as the GOLD + S definition) in an EDT startup 
command file makes the redefined keys available during every editing session. 

8.2.7.5 Defining EDT Macros 

An EDT macro allows you to execute a sequence of EDT line-editing 
commands whenever you invoke the macro. To define a macro, use the 
EDT line-editing command DEFINE MACRO to define the name of a buffer 
as the macro name. Then create and enter a buffer with the same name as 
the macro. (See Section 8.2.6.8 for information about using multiple buffers.) 
Once in the buffer, type the EDT line-editing commands in the desired 
sequence, one command per line. For example, the following macro inserts a 
four-line heading. 

INSERT;NAME: 

INSERT;DEPT: 

INSERT;DATE: 

INSERT;SUBJ: 

[EOB] 

Then exit from the buffer. To invoke the macro, enter its name as an EDT 
line-editing command. The lines of the heading are inserted at the cursor 
position: 

NAME: 

DEPT: 

DATE: 

SUBJ: 

To make a macro available during other editing sessions, you can place the 
DEFINE MACRO command and the macro command sequence in an EDT 
startup command file. When you include a macro definition in a startup 
command file, be sure the command sequence contains the commands for 
entering the macro buffer (FIND=buffer-name.) and returning to the MAIN 
buffer (FIND=MAIN.). Note that you must precede each command in the 
sequence with the INSERT command. For more information about key and 
macro definitions, see the VAX EDT Reference Manual. 
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9 Processing Files with DIGITAL Standard Runoff 


DIGITAL Standard Runoff (DSR) is a text formatter that processes source 
files into formatted text and intermediate files, and creates tables of contents 
and indexes. You process the source and intermediate files with the DCL 
commands RUNOFF, RUNOFF/CONTENTS, and RUNOFF/INDEX. With 
DSR, you can produce several types of documents including a memo, letter, 
and full-length manuscript. 


The DSR source file is a file you created with EDT, EVE, or another text 
editor. This file has a default file type of .RNO and contains text, DSR 
formatting commands, flags and control characters. (DSR flags are special 
characters that you insert in text to specify, for example, emphasis of text, case 
of characters, and spacing of characters.) When the source file is processed, 
the DSR commands cause the text to be formatted into sections, paragraphs, 
lists, and so on. You can direct DSR to provide title pages, footnotes, tables of 
contents, indexes, and appendixes for the source files it processes by inserting 
control characters and other special identifiers within your text. 

See the VAX DIGITAL Standard Runoff Reference Manual for rules on entering 
DSR commands and a description of each command. 

DSR commands start with the control flag, which by default is represented 
by a period. DSR commands can be typed in uppercase, lowercase, or a 
combination of uppercase and lowercase. You can abbreviate DSR command 
names, but the abbreviations must be exactly as listed in the VAX DIGITAL 
Standard Runoff Reference Manual. 



Formatting Text 

Using DSR, you can format text into paragraphs or lists, or maintain a literal 
display. You can adjust the margins and the spacing between lines or blocks 
of lines. DSR also provides commands for leaving blocks of space on a page 
and for writing notes and footnotes. 

You can control such features as bolding and underlining with embedded 
flags. By default, DSR treats certain characters as flags rather than text. 

For example, by default, a character is underlined if it is preceded by an 
ampersand (&). (To place an actual ampersand in the text, you must enter 
an ampersand preceded by an underscore (_&) flag, or you must turn off the 
flag governing that character.) One approach is to turn off all flags at the start 
of your DSR file. The following commands turn off all flags that are on by 
default: 
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Flag Command 

Flag Character 

.NO FLAGS ACCEPT 

Underscore (_) by default 

.NO FLAGS COMMENT 

Exclamation point (!) by default 

.NO FLAGS LOWERCASE 

Backslash (\) by default 

.NO FLAGS SPACE 

Number sign (#) by default 

.NO FLAGS SUBINDEX 

Right angle bracket (> ) by default 

.NO FLAGS UNDERLINE 

Ampersand (&) by default 

.NO FLAGS UPPERCASE 

Circumflex 0 by default 


When you need a particular flag, set the flag on (.FLAGS command), write 
the text that uses the flag, and set the flag off (.NO FLAGS command). (See 
Section 9.1.9.) You can change the special flag character when you specify 
the .FLAGS command. 

Following are several examples that illustrate how to use various DSR 
commands to produce formatted output: 

.BREAK 
.BLANK 
.BLANK 2 

.RIGHT MARGIN 34 

.CENTER;Twelve Days of Dieting 

In the previous example, the .BREAK command ends the current line. The 
.BLANK command without a parameter inserts a blank line in the text. The 
.BLANK command with the parameter 2 inserts two blank lines in the text. 
The .RIGHT MARGIN command sets the right margin at position 34. The 
.CENTER command centers the text following the semicolon. 

On any line containing a DSR command, the first item on the line must be 
a DSR command and the control flag must occupy position 1. Depending 
on the particular commands, a line containing a command may contain 
additional commands and text. In the following example, the DSR command 
occupies its own line. The end of the line terminates the command. 

.BLANK 2 

In the following example, the command and text are placed on one line. The 
semicolon acts as the command terminator. 

.CENTER;Twelve Days of Dieting 

In the following example, two commands are placed on one line. The 
beginning of the second command terminates the first command. 

.BLANK 2.CENTER;Twelve Days of Dieting 

The following example demonstrates the use of the DSR commands .BLANK 
and .CENTER to format text: 
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.RIGHT MARGIN 34 
.CENTER;Twelve Days of Dieting 
.CENTER;Watching Your Weight Increase 
.BLANK 2 

On the twelfth day of dieting, Millitsa gave to me, 

.BREAK 

Twelve hot fudge sundaes, 

.BREAK 

Eleven Hostess Twinkies, 

.BREAK 

Ten cherry cheese cakes, 

.BLANK 

Nine ladyfingers, 

.BREAK 

Eight date nut muffins, 

.BREAK 

Seven oatmeal cookies, 

.BREAK 

Six bags of Fritos, 

.BREAK 

Five coffee rings, 

.BLANK 

Four sticky buns, 

.BREAK 

Three Clark bars, 

.BREAK 

Two marbled cakes, 

.BREAK 

And a pizza with pepperoni. 

The preceding lines of text coded in DSR produce the following output: 

Twelve Days of Dieting 
Watching Your Weight Increase 

On the twelfth day of dieting, Millitsa gave to me, 

Twelve hot fudge sundaes, 

Eleven Hostess Twinkies, 

Ten cherry cheese cakes, 

Nine ladyfingers, 

Eight date nut muffins, 

Seven oatmeal cookies, 

Six bags of Fritos, 

Five coffee rings, 

Four sticky buns, 

Three Clark bars, 

Two marbled cakes, 

And a pizza with pepperoni. 

Do not edit the output file from a DSR operation. Instead, modify the DSR 
file and reprocess it. If you do make minor modifications to the output file, 
the file does not have the carriage return record attribute (which causes 
each record in the file to produce a new line automatically when the file is 
displayed or printed). The carriage return and line feed control characters are 
embedded in the file. 
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9.1.1 Filling and Justifying Text 

By default, DSR fills and justifies text. Filling adds words to each output 
line until the addition of another word would exceed the right margin. 
Justification inserts additional space between words on a line so that the last 
word reaches the right margin. The following example demonstrates how text 
is filled and justified: 

.RIGHT MARGIN 45 
For it so falls out, 

That what we have 
we prize not 
to the worth 
while we enjoy it; 
but being lacked, 
lacked and lost, 

Why, 

then we rack the value. 

The preceding lines of text coded in DSR produce the following output: 

For it so falls out, That what we have 
we prize not to the worth while we enjoy 
it; but being lacked, lacked and lost, 

Why, then we rack the value. 

If you do not want filling or justification, you must explicitly specify the 
.NO FILL command or the .NO JUSTIFY command before you write the 
text. Turn filling or justifying back on by specifying the .FILL or .JUSTIFY 
command. The following example turns off justification but retains filling, 
which produces a ragged right margin: 

.RIGHT MARGIN 45 

.NO JUSTIFY 

For it so falls out, 

That what we have 
we prize not 
to the worth 
while we enjoy it; 
but being lacked, 
lacked and lost, 

Why, 

then we rack the value. 

.JUSTIFY 

The preceding lines of text coded in DSR produce the following output: 

For it so falls out, That what we have 
we prize not to the worth while we enjoy 
it; but being lacked, lacked and lost, 

Why, then we rack the value. 

The next example turns off both filling and justifying, which formats the 
output lines in the same way as the input lines: 


9-4 









Processing Files with DIGITAL Standard Runoff 

9.1 Formatting Text 


.NO FILL.NO JUSTIFY 
For it so falls out, 

That what we have 
we prize not 
to the worth 
while we enjoy it; 
but being lacked, 
lacked and lost, 

Why, 

then we rack the value. 

.FILL.JUSTIFY 

The preceding lines of text coded in DSR produce the following output: 

For it so falls out, 

That what we have 
we prize not 
to the worth 
while we enjoy it; 
but being lacked, 
lacked and lost, 

Why, 

then we rack the value. 


9.1.2 Adjusting Margins and Centering Text 

By default, margins are set at 0 and 70. Change the margin settings with the 
.LEFT MARGIN and .RIGHT MARGIN commands. The following example 
changes the right margin to position 60: 

.RIGHT MARGIN 60 


To indent one or more lines of text on the left, increase the left margin setting. 
After you write the indented text, decrease the left margin setting by the same 
amount. Indent on the right by decreasing the right margin setting, writing 
the text, and increasing the right margin setting. The following example 
indents text by 10 spaces on either margin: 


.LEFT MARGIN +10.RIGHT MARGIN -10 
indented text 

.LEFT MARGIN -10.RIGHT MARGIN +10 


You can indent a single line of text from the left margin with the .INDENT 
command. The following example indents a line of text eight spaces: 

.INDENT 8 

I wandered lonely as a cloud 

Indent a single line of text from the right margin with the .RIGHT command. 
You can also use the .RIGHT command to position a single line of text against 
the right margin as follows: 


.RIGHT 0 

I wandered lonely as a cloud 
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To center text between two margins, use the .CENTER command. Place the 
text to be centered on the line following the command as follows: 

.CENTER 

I wandered lonely as a cloud 

You can also end the .CENTER command with a semicolon, and place the 
text to be centered on the same line as follows: 

.CENTER;! wandered lonely as a cloud 


9.1.3 Formatting Paragraphs 

To separate text into paragraphs, place the .PARAGRAPH command between 
paragraphs. By default, the .PARAGRAPH command indents the first line 
of a paragraph five spaces, inserts one blank line before starting a new 
paragraph, and tests to ensure that room remains on the page for at least four 
lines of text. You can change the parameter values when you type your first 
.PARAGRAPH command or by placing a .SET PARAGRAPH command at the 
top of the file. The following example does not indent the first line of each 
paragraph and ensures that room remains on the page for at least three lines 
of text: 

.SET PARAGRAPH 0,1,1 
paragraph of text 
.PARAGRAPH 
paragraph of text 
.PARAGRAPH 


You can also separate text by inserting .BLANK or .SKIP commands. The 
.BLANK command inserts the exact number of lines specified by the 
parameter (which defaults to 1). The .BLANK command does not provide 
for indentation or for testing the room left on the page; perform these actions 
with the .INDENT and .TEST PAGE commands. The following example 
separates two blocks of text with one blank line after first testing to ensure 
that at least three lines remain on the page: 

paragraph of text 
.TEST PAGE 3 
.BLANK 

paragraph of text 

The .SKIP command takes into account the spacing you have in effect. When 
the default is in effect (spacing is 1), .BLANK and .SKIP are equivalent. 
However, if multiple spacing is in effect, the .SKIP command multiplies the 
skip value by the spacing value. You can specify something other than single 
spacing with the .SPACING command. (The .SPACING command also affects 
the test page value in the .PARAGRAPH and .SET PARAGRAPH commands.) 
The following example demonstrates double spacing, with two extra lines 
between blocks of text: 
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.SPACING 2 
block of text 
.SKIP 

block of text 
.SKIP 


9.1.4 Formatting Literal Text 

To have text appear in the output file exactly as it appears in the DSR source 
file, enclose it with .LITERAL and .END LITERAL commands as follows: 

.RIGHT MARGIN 34 
.BLANK 2 
.LITERAL 

Twelve Days of Dieting 
Watching Your Weight Increase 

On the twelfth day of dieting, Millitsa gave to me, 

Twelve hot fudge sundaes, 

Eleven Hostess Twinkies, 

Ten cherry cheese cakes, 

Nine ladyfingers, 

Eight date nut muffins, 

Seven oatmeal cookies, 

Six bags of Fritos, 

Five coffee rings, 

Four sticky buns, 

Three Clark bars, 

Two marbled cakes, 

And a pizza with pepperoni. 

.END LITERAL 

The preceding lines coded in DSR produce the following output: 

Twelve Days of Dieting 
Watching Your Weight Increase 

On the twelfth day of dieting, Millitsa gave to me, 

Twelve hot fudge sundaes, 

Eleven Hostess Twinkies, 

Ten cherry cheese cakes, 

Nine ladyfingers, 

Eight date nut muffins, 

Seven oatmeal cookies, 

Six bags of Fritos, 

Five coffee rings, 

Four sticky buns, 

Three Clark bars, 

Two marbled cakes, 

And a pizza with pepperoni. 

Literal text is not filled and not justified; lines are the same as in the input 
file. Except for the .END LITERAL command, commands and flags are not 
recognized in literal text. In addition, commands and flags placed before the 
literal text do not affect the literal text except that you can set the left margin, 
set tab stops, set spacing, start bolding, and start underlining. You cannot 
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reset any of these items until the literal text ends (for example, you would 
have to bold the entire literal block). The following example indents the 
literal text (the .MARGIN commands must be outside the literal block): 

the text filled and justified 

.LEFT MARGIN +5 

.LITERAL 

the literal text 
.END LITERAL 
.LEFT MARGIN -5 

If you want the positional effect of literal text but also want to use commands 
and flags, you can turn off filling and justifying (.NO FILL and .NO JUSTIFY) 
and turn it back on after the literal text. If the literal text contains blank lines, 
specify .KEEP when you turn off the filling and justification as follows: 

the text filled and justified 
.NO FILL 
.NO JUSTIFY 
.KEEP 

the literal text 
.FILL 
.JUSTIFY 
.NO KEEP 

For a small number of lines, you might place .BREAK or .BLANK commands 
(specify .BLANK 0 for single spacing) between the literal lines. 


9.1.5 Formatting Lists 

You can format text as lists. Although by default DSR creates a numbered 
list, you can create a bulleted or lettered list or use any other character or 
symbol to precede the list elements. 


9.1.5.1 Numbered Lists 

The following three commands format a numbered list: 

• .LIST—Starts the list by leaving one blank line and indenting. The text of 
the list is indented nine spaces if the left margin is currently 0. Otherwise, 
the text of the list is indented four spaces. 

• .LIST ELEMENT—Starts an element (an item) within the list. You can 
have any number of elements. 

• .END LIST—Ends the list and writes a blank line. 

Each element is preceded by a number starting with 1. Elements are 
separated by blank lines as follows: 

.LIST 

.LIST ELEMENT;grosbeak 
.LIST ELEMENT;goldfinch 
.LIST ELEMENT;redpoll 
.LIST ELEMENT;sparrow 
.END LIST 
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The preceding lines of text coded in DSR produce the following output: 

1. grosbeak 

2. goldfinch 

3. redpoll 

4. sparrow 

Text for each list element can be placed after the semicolon terminating the 
command (as shown in the example) or can be placed on a line or lines 
following the command. A single list element continues until the next .LIST 
ELEMENT command or an .END LIST command occurs. The list element can 
contain commands and flags. 

To change the spacing between list elements, specify the number of spaces 
as parameter 1 to the .LIST command. For example, .LIST 0 places no spaces 
between list elements. 


9.1.5.2 Bulleted Lists 

If you do not want your list to be numbered, as it is by default, substitute 
another character for the numbers by specifying that character as the second 
parameter of the .LIST command. Enclose the character in quotation marks 
or apostrophes; the character does not have to be preceded by a comma if the 
first parameter is not specified. In the following example, the lowercase "a" 
gives the effect of an unfilled bullet: 

.LIST "o" 

.LIST ELEMENT;ferret 
.LIST ELEMENT;mink 
.LIST ELEMENT;rabbit 
.LIST ELEMENT;sable 
.LIST ELEMENT;raccoon 
.END LIST 

The preceding lines of text coded in DSR produce the following output: 

o ferret 
o mink 
o rabbit 
o sable 
o raccoon 


9-9 









Processing Files with DIGITAL Standard Runoff 

9.1 Formatting Text 


9.1.5.3 Nested Lists 

You can nest one list within another as long as the nested list is entirely 
within one element of the outer list as follows: 

.LIST 0 

.LIST ELEMENT;German 
.LIST ELEMENT;Russian 
.LIST ELEMENT;Swedish 
.LIST ELEMENT;Yugoslavian 
.LIST 0,"o" 

.LIST ELEMENT;Serbian 
.LIST ELEMENT;Croatian 
.LIST ELEMENT;Macedonian 
.END LIST 

.LIST ELEMENT;Turkish 
.LIST ELEMENT;Scottish 
.LIST ELEMENT;Irish 
.END LIST 

The preceding lines of text coded in DSR produce the following output: 


i. 

German 

2. 

Russian 

3. 

Swedish 

4. 

Yugoslavian 


o Serbian 


o Croatian 


o Macedonian 

5. 

Turkish 

6. 

Scottish 

7. 

Irish 


9.1.5.4 Lists Beginning with Letters and Roman Numerals 

By default, DSR numbers lists with decimal numbers. You can, however, 
produce a list whose elements are preceded by uppercase or lowercase letters 
or Roman numerals by specifying the .DISPLAY ELEMENTS command. You 
must place the .DISPLAY ELEMENTS command between the .LIST command 
and the first .LIST ELEMENT command. The following example produces a 
numbered list using lowercase Roman numerals: 

.LIST 0 

.DISPLAY ELEMENTS RL 
.LIST ELEMENT;tan 
.LIST ELEMENT;beige 
.LIST ELEMENT;rust 
.LIST ELEMENT;brown 
.END LIST 

The preceding lines of text coded in DSR produce the following output: 

i. tan 

ii. beige 

iii. rust 

iv. brown 
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9.1.6 Leaving Space on a Page 

The text of a file usually starts on the fourth or fifth line from the top of 
a page, depending on the layout of the document. To leave extra space at 
the top of a page, specify an amount in a .FIGURE command (the .BLANK 
command does not work at the top of a page). To leave extra space in the 
middle of a page, use either the .FIGURE or .BLANK command. If you want 
a certain amount of space all on one page, use the .FIGURE or .FIGURE 
DEFERRED command. These commands insert the required space on the 
next page if it does not fit on the current page. While the .FIGURE command 
leaves the rest of the current page blank, the .FIGURE DEFERRED command 
fills the rest of the current page using the text and commands that follow the 
.FIGURE DEFERRED command. 

The following example writes 40 blank lines to the current page if they will 
fit; otherwise, the 40 blank lines are placed at the top of the next page, 
and the current page is filled from the input lines following the .FIGURE 
DEFERRED line. 

text filled and justified 
.FIGURE DEFERRED 40 
text filled and justified 

You can also create space on a page by entering the .LITERAL command, 
pressing RETURN once for each empty line, and entering the .END LITERAL 
command. This technique allows you to see the amount of space you are 
creating. However, the space will be split if you cross page boundaries. 


9.1.7 Formatting Notes 

The .NOTE command narrows the left and right margins, inserts a blank 
line, writes a centered title, inserts another blank line, and writes the text that 
follows the .NOTE command. The .END NOTE command writes a blank line 
and restores the margin settings. The title defaults to the word NOTE. 

The following example writes a note with the title CAUTION: 

.NOTE CAUTION 

Do not operate the machine outdoors in wet weather. 

Do not operate the machine in a wet area indoors or outdoors. 

Such actions may lead to a severe electrical shock. 

.END NOTE 

The preceding lines of text coded in DSR produce the following output: 

CAUTION 

Do not operate the machine outdoors in wet weather. 

Do not operate the machine in a wet area indoors or 
outdoors. Such actions may lead to a severe 
electrical shock. 
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9.1.8 Formatting Footnotes 

The .FOOTNOTE command places the text following the command at the 
bottom of the page if enough room exists. If the entire footnote does not fit, 
the whole footnote is placed at the bottom of the next page. No automatic 
formatting occurs; you must determine how to format the footnote with DSR 
commands. In addition, no automatic footnote symbols are provided. The 
.END FOOTNOTE command ends the footnote and automatically restores 
any case, fill, justify, and margin settings you might have changed within the 
footnote. 

The following example demonstrates the use of a footnote: 

Press the START button firmly. 

Release the START button as soon as the engine starts.(1) 

.FOOTNOTE.BLANK.LEFT MARGIN +4.INDENT -4 

( 1 ) 

If the engine does not crank, ensure that the battery cables 
are firmly connected to the battery. Sometimes the cables are 
disconnected for shipping. 

.END FOOTNOTE 

Push the choke in until you hear it click. 

Pull the throttle about halfway down but do not let the 
engine stall. 

After about two minutes, push the choke all the way in 
and pull the throttle all the way down. 

.PARAGRAPH 0 

Before engaging the drive train, ensure that you are in a 
comfortable position to operate the machine. 

Two seat controls are provided for your comfort. 

The preceding lines of text coded in DSR produce the following output: 

Press the START button firmly. Release the START button as 
soon as the engine starts.(1) Push the choke in until you 
hear it click. Pull the throttle about halfway down but do 
not let the engine stall. After about two minutes, push the 
choke all the way in and pull the throttle all the way down. 

Before engaging the drive train, ensure that you are in a 
comfortable position to operate the machine. Two seat 
controls are provided for your comfort. 

(1) If the engine does not crank, ensure that the battery 
cables are firmly connected to the battery. Sometimes 
the cables are disconnected for shipping. 


9.1.9 Bolding and Underlining Text 

The following steps describe how to bold a single character: 

1 Turn the bold flag on. (The bold flag is off by default.) 

2 In the text, precede the character to be bolded by the bold flag (an asterisk 
by default). 

3 Turn the bold flag off to enable the use of the flag as a normal character. 

The following example bolds the numbers 3 and 7: 

.FLAGS BOLD 

Follow route *3 to route *7. 

.NOFLAGS BOLD 
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The following steps describe how to underline a single character: 

1 Turn the underline flag on. (The underline flag is on by default.) 

2 In the text, precede the character to be underlined by the underline flag 
(an ampersand by default). 

3 Turn the underline flag off to enable the use of the flag as a normal 
character. 

The following example underlines the letters A and B: 

.FLAGS UNDERLINE 

kk is for Amy and &B is for Basil. 

.NOFLAGS UNDERLINE 

The following steps describe how to bold or underline a block of text: 

1 Turn on the uppercase and lowercase flags (they are on by default) in 
addition to the bold or underline flag. 

2 Start the block of text with the uppercase flag (a circumflex by default) 
followed by the bold or underline flag. 

3 End the block of text with the lowercase flag (a backslash by default) 
followed by the bold or underline flag. 

The following example bolds a line of text: 

.FLAGS BOLD 

.FLAGS UPPERCASE 

.FLAGS LOWERCASE 

'♦KEEP OFF THE GRASS, PLEASEX* 

.NOFLAGS BOLD 
.NOFLAGS UPPERCASE 
.NOFLAGS LOWERCASE 


9.2 Laying Out a Document 

By default, DSR produces a document of consecutively numbered pages (that 
is, if you do not specify .LAYOUT, .CHAPTER, or .APPENDIX commands). 
On each page, the text area is the fourth line through the bottom line. Page 
numbers appear in the upper right corner as "Page 2," "Page 3," and so on, 
starting with page 2. Running heads (chapter names or other designated text) 
appear in the upper left corner. 

You can adjust the position of page numbers and running heads with the 
.LAYOUT command. Layout codes 1, 2, and 3 center the page number at the 
bottom of the page and adjust the running heads as follows: 

• Layout code 1 centers running heads at the top of the page. 

• Layout code 2 moves the running heads to one upper comer or the other 
depending on whether the page number is odd or even. 

• Layout code 3 puts the running heads in the upper left comer and puts 
the date in the upper right corner. 

Specify the .LAYOUT command at the beginning of your file. The following 
command adjusts the layout to code 2: 

.LAYOUT 2,3 
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9.2.1 


Chapters and Appendixes 

To divide a document into chapters, start each chapter with the .CHAPTER 
command. The title of the chapter must follow the command name on the 
same line. The lines following the .CHAPTER command are part of that 
chapter until you enter another .CHAPTER command or an .APPENDIX 
command. 

By default, chapters are numbered consecutively within the document, 
beginning with Chapter 1. You can force the numbering of a chapter (for 
example, in order to place each chapter in a separate file) by preceding the 
.CHAPTER command with a .NUMBER CHAPTER command. The following 
example begins Chapter 2: 


.NUMBER CHAPTER 2 
.CHAPTER starting procedures 

The preceding lines of text coded in DSR produce the following output: 
<12 blank lines> 

CHAPTER 2 

STARTING PROCEDURES 


DSR starts a chapter on a new page with 12 blank lines at the top of the 
page. The number of the chapter and the chapter title are centered on the 
page in uppercase characters. You can adjust the appearance of the chapter 
number with the .DISPLAY CHAPTER command. 


The .APPENDIX, .NUMBER APPENDIX, and .DISPLAY APPENDIX 
commands work similarly to the chapter commands. However, by default, 
appendixes are lettered sequentially starting with Appendix A. The following 
example starts Appendix C: 


NUMBER APPENDIX C 

.APPENDIX connecting the battery 


9.2.2 Sections 


The .HEADER LEVEL command divides a document into sections and 
subsections identified by a decimal numbering scheme to a maximum 
depth of 6. The topmost section is header level 1. Each level is numbered 
sequentially starting with 1 unless a .NUMBER LEVEL command precedes 
the .HEADER LEVEL command. The following example shows a document 
with three sections: 


text 

.HEADER LEVEL 
text 

.HEADER LEVEL 
text 

.HEADER LEVEL 
text 


1 normal starting 
1 cold weather starting 
1 troubleshooting 


9-14 










Processing Files with DIGITAL Standard Runoff 

9.2 Laying Out a Document 


The preceding lines of text coded in DSR produce the following output: 

text 

1 NORMAL STARTING 
text 

2 COLD WEATHER STARTING 
text 

3 TROUBLESHOOTING 
text 

Subsections are numbered within their respective higher-level sections as 
follows: 

text 

.HEADER LEVEL 1 normal starting 
text 

.HEADER LEVEL 2 cold engine 
text 

.HEADER LEVEL 2 warm engine 
text 

.HEADER LEVEL 1 cold weather starting 
text 

.HEADER LEVEL 2 above zero 
text 

.HEADER LEVEL 2 below zero 
text 

.HEADER LEVEL 1 troubleshooting 
text 

The preceding lines of text coded in DSR produce the following output: 

text 

1 NORMAL STARTING 
text 

1.1 Cold Engine 
text 

1.2 Warm Engine 
text 

2 COLD WEATHER STARTING 
text 

2.1 Above Zero 
text 

2.2 Below Zero 
text 

3 TROUBLESHOOTING 
text 

If the sections are within chapters or appendixes, the section number is 
prefixed by the chapter or appendix identifier and a decimal point as follows: 

.NUMBER CHAPTER 2 

.CHAPTER starting procedures 

text 

.HEADER LEVEL 1 normal starting 
text 

.HEADER LEVEL 1 cold weather starting 
text 

.HEADER LEVEL 1 troubleshooting 
text 
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The preceding lines of text coded in DSR produce the following output: 

the chapter heading and text 

2.1 NORMAL STARTING 
text 

2.2 COLD WEATHER STARTING 
text 

2.3 TROUBLESHOOTING 
text 

You can force the numbering of a section with the .NUMBER LEVEL 
command. The following example forces the start of section 1.2: 

.NUMBER LEVEL 1.2 
.HEADER LEVEL 2 Warm Engine 

You can change the appearance of section headers with the .STYLE 
HEADERS command. The default .STYLE HEADERS settings cause level 
1 headers to be written in all uppercase and level 2 headers to be written 
with the initial letter of every word in uppercase. The following command 
changes the settings so that the headers below level 1 are written exactly as 
you type them: 

.STYLE HEADERS 3.1.0.7,7,2,1,9,2 


9.2.3 Running Heads 


By default, chapter and appendix titles appear as the first line of running 
heads. If the document does not contain chapters or appendixes, no running 
heads appear. Running heads are always placed at the top of the page; their 
exact position can be changed with the .LAYOUT command. 

To use level 1 header titles as the second line of running heads, enter the 
following commands at the start of your DSR file: 

•SUBTITLE 

.AUTOSUBTITLE 

To use titles other than chapter and section titles as running heads, use the 
.TITLE and .SUBTITLE commands. The .TITLE command affects the first line 
of the running head; the .SUBTITLE command affects the second line of the 
running head. 

The title specified by a .TITLE command remains in effect until you specify 
another .TITLE or .CHAPTER command. If you want to use a specified title 
in place of a chapter name, enter the .TITLE command immediately after the 
.CHAPTER command. The title specified by a .SUBTITLE command remains 
in effect until you specify another .SUBTITLE command or until a .HEADER 
LEVEL command occurs (if automatic subtitles are in effect). 
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9.2.4 Pagination 

If the document is not divided into chapters, pagination is sequential 
throughout the document. If the document is chapter oriented, pagination 
is sequential throughout the document only if .LAYOUT 3 is in effect. 
Otherwise, pagination is sequential within each chapter and appendix; the 
page number starts with the chapter or appendix identifier and a hyphen. 

You can suspend the numbering of pages with the .NO NUMBER command 
(unless .LAYOUT 3 is in effect). Create a document that is not paged (no 
running heads, no page numbers) by entering the command .NO PAGING. 


9.3 Processing DSR Files 

Enter the RUNOFF command to process a DSR file. Specify the name of 
the DSR file as the parameter; the file type defaults to RNO. The following 
example processes a file named EXAMPLE.RNO in your default directory. 

$ RUNOFF EXAMPLE 

If you do not specify the /OUTPUT qualifier, the RUNOFF command 
produces an output file with the same name as the input file and a file 
type of MEM. The preceding example produces an output file named 
EXAMPLE.MEM. The following example produces an output file named 
EX AMPLE. MEM from a DSR file named TEMPLATE.RNO: 

$ RUNOFF/OUTPUT=EXAMPLE TEMPLATE 

See the VAX DIGITAL Standard Runoff Reference Manual for a complete 
description of the RUNOFF command and its qualifiers. 


9.3.1 Producing a Table of Contents 

The table of contents you produce can display chapter titles and numbers, 
header levels, and appendix titles and letters. To produce a table of contents, 
do the following: 

1 Enter the command RUNOFF/INTERMEDIATE, specifying the RNO file 
as the parameter. The name of the intermediate file produced is the same 
as the name of the DSR file with a file type of BRN, unless you specify 

a different name. You will also get the usual output (MEM) file; you can 
specify /NOOUTPUT if you do not want the MEM file. 

2 Enter the command RUNOFF/CONTENTS, specifying the intermediate 
file as the parameter. This command produces an unformatted table of 
contents file with the same name as the input file but with a file type of 
RNT. 

3 Enter the RUNOFF command, specifying the RNT file as the parameter. 
You must specify the file type. This command produces a formatted table 
of contents file with a file type of MEC. 

The following example processes a file named OPER.RNO. It produces an 
output file named OPER.MEM and a table of contents named OPER.MEC: 


$ RUNOFF/INTERMEDIATE OPER 
$ RUNOFF/CONTENTS OPER 
$ RUNOFF OPER.RNT 
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9.3 Processing DSR Files 


To produce a table of contents from more than one file, you must concatenate 
the intermediate files when you enter the RUNOFF/CONTENTS command. 
(You cannot use wildcard characters.) The following example produces output 
files and a single table of contents from three DSR files: 

$ RUNOFF/INTERMEDIATE 0PER1 
$ RUNOFF/INTERMEDIATE 0PER2 
$ RUNOFF/INTERMEDIATE 0PER3 

$ RUNOFF/CONTENTS/0UTPUT=0PER 0PER1+0PER2+0PER3 
$ RUNOFF OPER.RNT 

The table of contents is based on the .CHAPTER, .APPENDIX, and .HEADER 
LEVEL commands in your DSR file. You can control the formatting to some 
extent with the qualifiers to the RUNOFF/CONTENTS command. You can 
write additional information to the table of contents with the command 
.SEND TOC. 

See the VAX DIGITAL Standard Runoff Reference Manual for more information 
about producing a table of contents with DSR. 


9.3.2 Producing an Index 

To create an index, you enter .INDEX and .ENTRY commands throughout 
your DSR file. (You can also use the index flag to index a word of text.) 

The .INDEX command names an item to be placed in the index. Position the 
.INDEX command as close as possible to the text being indexed. The item 
appears in the index followed by the number of the page on which it was 
written to the formatted text (MEM) file. The following example makes index 
entries for each section: 

text 

.HEADER LEVEL 1 Normal Starting 

.INDEX Normal starting 

text 

.HEADER LEVEL 1 Cold Weather Starting 

.INDEX Cold weather starting 

text 

.HEADER LEVEL 1 Troubleshooting 

.INDEX Troubleshooting 

text 

The index entries would appear as follows: 

Cold weather starting, 2-2 
Normal starting, 2-1 
Troubleshooting, 2-3 

Use the subindex flag (by default a right angle bracket) to indicate subentries 
in the index. A subentry is listed under the higher-level item in the index 
and has its own page number. The subindex flag must be turned on. The 
following example produces one index entry for "Starting" under which are 
listed the two subentries "normal" and "cold weather": 
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9.3 Processing DSR Files 


text 

.HEADER LEVEL 1 Normal Starting 
.FLAGS SUBINDEX 
.INDEX Normal starting 
.INDEX Starting>normal 
.NOFLAGS SUBINDEX 
text 

.HEADER LEVEL 1 Cold Weather Starting 

.FLAGS SUBINDEX 

.INDEX Cold weather starting 

.INDEX Starting>cold weather 

.NOFLAGS SUBINDEX 

text 

.HEADER LEVEL 1 Troubleshooting 

.INDEX Troubleshooting 

text 

The index entry for "Starting" would appear as follows: 

Starting 

cold weather, 2-2 
normal, 2-1 

You can make an entry without a page number in the index with the .ENTRY 
command. Usually these index entries are used for cross references. The 
following example produces an index entry for "Weather," under which the 
subentry "see cold weather" appears without a page number: 

.FLAGS SUBINDEX 

.ENTRY Weather>see cold weather 

The index entry would appear as follows: 

Weather 

see cold weather 

After you enter the index commands to your file, you are ready to run the 
indexing program. To produce an index, do the following: 

1 Enter the command RUNOFF/INTERMEDIATE, specifying your RNO 
file as the parameter. The name of the intermediate file produced is the 
same as the name of the DSR file but with a file type of BRN, unless you 
specify a different name. You will also get the usual output (MEM) file; 
you can specify /NOOUTPUT if you do not want the MEM file. 

2 Enter the command RUNOFF/INDEX, specifying the intermediate file as 
the parameter. This command produces an unformatted index file with 
the same name as the input file but with a file type of RNX. 

3 Enter the RUNOFF command, specifying the RNX file as the parameter. 
You must specify the file type. This command produces a formatted index 
file with a file type of MEX. 

The following example processes a file named OPER.RNO. It produces an 
output file named OPER.MEM, a table of contents named OPER.MEC, and 
an index named OPER.MEX. 

$ RUNOFF/INTERMEDIATE OPER 
$ RUNOFF/CONTENTS OPER 
$ RUNOFF/INDEX OPER 
$ RUNOFF OPER.RNT 
$ RUNOFF OPER.RNX 
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9.3 Processing DSR Files 


To produce an index from more than one file, you must concatenate the 
intermediate files when you enter the RUNOFF/INDEX command. (You 
cannot use wildcard characters.) The following example produces formatted 
text files, a single table of contents, and a single index from three DSR files: 

$ RUNOFF/INTERMEDIATE 0PER1 
$ RUNOFF/INTERMEDIATE 0PER2 
$ RUNOFF/INTERMEDIATE 0PER3 

$ RUNOFF/C0NTENTS/0UTPUT=0PER 0PER1+0PER2+0PER3 
$ RUNOFF/INDEX/OUTPUT=OPER 0PER1+0PER2+0PER3 
$ RUNOFF OPER.RNT 
$ RUNOFF OPER.RNX 


9.3.3 Printing Output Files 

The following are guidelines for printing nonlaser-output files produced by 
DSR: 

• Copying files—You can copy a file (with the COPY command) to a 
printer, but you may occasionally lose a form feed. You lose a form feed 
when the size of an output page equals 66 or the value that 
SYS$LP_LINES had at the time the file was created if SYS$LP_LINES 
was defined as a logical name. (Note that the current value of 
SYS$LP_LINES has no effect on the output file after it is created.) 

• Generating automatic form feeds—In general, use the default for the DCL 
command PRINT (PRINT/FEED) to generate form feeds automatically 
when printing nonlaser files. However, you may occasionally generate a 
blank page. More precisely, you generate a blank page when an output 
page equals 66 or the value that SYS$LP_LINES had at the time the file 
was created if SYS$LP_LINES was defined as a logical name. (Note that 
the current value of SYS$LP_LINES has no effect on the output file.) If 
you specify PRINT/NOFEED, you eliminate the chance of a blank page, 
but you take the chance of losing pages under the same circumstances as 
a COPY operation. 

The following example shows a laser printer setup in a command procedure. 
Dsr$ln01 is the name you assign the laser printer form. LpbO is the name of 
the printer. 

$ ! Define form for dsr output on InOl laser printer 
$ 

$ DEFINE/FORM dsr$ln01 /MARGIN=(B0TT0M=0) - 
/NOWRAP - 
/NOTRUNCATE - 
/STOCK=DEFAULT - 

/DESCRIPTION="dsr InOl form definition" 

$ 

$ ! Set up InOl laser printer for dsr output 
$ 

$ SET PRINTER lpbO /NOTRUNCATE - 
/NOWRAP - 
/TAB - 
/PRINTALL - 
/FF - 
/NOCR 


9-20 









Processing Files with DIGITAL Standard Runoff 

9.3 Processing DSR Files 


The print command should specify /NOFEED, the name of the form, and 
the name of the queue. You should equate this command to a global symbol 
in your login file or in the system login file. The following example makes 
LNPRINT a global symbol that prints LN01 files: 

$ ! Set up lnprint as print command for InOl laser printer 
$ 

$ LNP*RINT == M PRINT/N0FEED/F0RM=dsr$lnOl/QUEUE=lnOl„queue" 












J\ Character Sets 


The following tables present the ASCII character set and the DEC 
Multinational Character Set. 


A.1 ASCII Character Set 

The ASCII character set consists of the characters shown in the following 
table. The characters with names are not printable. (The ASCII character 
set comprises the first 127 characters of the DEC Multinational Character 
Set; descriptions of the nonprintable characters are located in the table 
in Section A.3.) You can calculate the numeric value of a character by 
constructing a 2-digit hexadecimal number in which the column position of 
the character represents the 16s position of the hexadecimal number and the 
row position of the character represents the units position of the number. 
For example, an uppercase A has the numeric value 41 hexadecimal. String 
comparisons are made using these values. 


Hex 

Values 

0 

1 

2 

3 

4 

5 

6 

7 

0 

NUL 

DLE 

SP 

0 

(0) 

P 

\ 

P 

1 

SOH 

DC1 
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1 

A 

Q 

a 

q 

2 

STX 

DC2 

if 
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B 

R 

b 

r 
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ETX 

DC3 

# 

3 

C 

S 

c 

s 
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EOT 

DC4 

$ 

4 

D 

T 

d 

t 
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NAK 

% 

5 

E 
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e 

u 

6 

ACK 

SYN 

& 

6 

F 

V 

f 

V 
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BEL 

ETB 

/ 

7 

G 

w 

g 

w 
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BS 

CAN 

( 

8 

H 

X 

h 

X 

9 

HT 

EM 

) 

9 
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Y 

i 

y 

A 

LF 

SUB 

* 


J 

Z 

j 

z 

B 

VT 

ESC 

+ 

* 

K 

[ 

k 

i 

C 

FF 

FS 

/ 

< 

K 

\ 

1 

1 

D 

CR 

GS 

— 
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M 

J 

m 

l 

E 

SO 

RS 


> 

N 


n 


F 

SI 

US 

/ 

9 

0 

— 

o 

DEL 
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A.2 ASCII and DEC Multinational Character Set Tables 

Table A-l represents the ASCII character set (characters with decimal values 
0 through 127). The first half of each of the numbered columns identifies 
the character as you would enter it on a VT300-, VT200-, or VTlOO-series 
terminal or as you would see it on a printer (except for the nonprintable 
characters). The remaining half of each column identifies the character by 
the binary value of the byte; the value is stated in three radixes—octal, 
decimal, and hexadecimal. For example, the uppercase letter A has, under 
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A.2 ASCII and DEC Multinational Character Set Tables 


ASCII conventions, a storage value of hexadecimal 41 (a bit configuration of 
01000001), equivalent to 101 in octal notation and 65 in decimal notation. 


Table A-1 Graphical Representation of the ASCII Character Set 



COLUMN 

0 

1 

2 

3 

4 

5 

6 

7 

h8 BITS 

b7 

0 

n 
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0 

0 

0 

0 

0 

1 

0 

i 

0 

0 

ROW 

b6 

b5 

b4 b3 b2 bl 


0 

0 

0 

1 


1 

0 

1 

1 

0 

0 

0 

1 

i 

0 

i 

i 

i 

0 

0 0 0 0 

NUL 

0 

0 

0 

DLE 

20 

16 

10 

SP 

40 

32 

20 

0 

60 

48 

30 

@ 

100 

64 

40 

p 

120 

80 

50 

\ 

140 

96 

60 

P 

160 

112 

70 

1 

0 0 0 1 

SOH 

1 

1 

1 

DC1 

IXON) 

21 

17 

11 

! 

41 

33 

21 

1 

61 

49 

31 

A 

101 

65 

41 

Q 

121 

81 

51 

a 

141 

97 

61 

q 

161 

113 

71 

2 

0 0 10 

STX 

2 

2 

2 

DC2 

22 

18 

12 

f 1 

42 

34 

22 

2 

62 

50 

32 

B 

102 

66 

42 

R 

122 

82 

52 

b 

142 

98 

62 

r 

162 

114 

72 

3 

0 0 11 

ETX 

3 

3 

3 

DC3 

(XOFF} 

23 

19 

13 

# 

43 

35 

23 

3 

63 

51 

33 

C 

103 

67 

43 

S 

123 

83 

53 

c 

143 

99 

63 

s 

163 

115 

73 

4 

0 10 0 

EOT 

4 

4 

4 

DC4 

24 

20 

14 

$ 

44 

36 

24 

4 

64 

52 

34 

D 

104 

68 

44 

T 

124 

84 

54 

d 

144 

100 

64 

t 

164 

116 

74 

5 

0 10 1 

ENQ 

5 

5 

5 

NAK 

25 

21 

15 

% 

45 

37 

25 

5 

65 

53 

35 

E 

105 

69 

45 

U 

125 

85 

55 

e 

145 

101 

65 

u 

165 

117 

75 

6 

0 110 

ACK 

6 

6 

6 

SYN 

26 

22 

16 

& 

46 

38 

26 

6 

66 

54 

36 

F 

106 

70 

46 

V 

126 

86 

56 

t 

146 

102 

66 

V 

166 

118 

76 

7 

0 111 

BEL 
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7 

7 

ETB 

27 

23 

17 

/ 

47 

39 

27 

7 

67 

55 

37 

G 

107 

71 

47 

w 

127 

87 

57 

9 

147 

103 

67 

w 

167 

119 

77 

8 

10 0 0 

BS 

10 

8 

8 

CAN 

30 

24 

18 

( 

50 

40 

28 

8 

70 

56 

38 

H 

110 

72 

48 

X 

130 

88 

58 

h 

150 

104 

68 

X 
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78 

9 

10 0 1 

HT 

11 

9 

9 

EM 

31 

25 

19 

) 

51 

41 

29 

9 

71 

57 

39 

I 
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73 

49 

Y 
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89 

59 

i 
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69 

y 
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79 

10 
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LF 

12 

10 

A 

SUB 

32 

26 

1A 

* 

52 

42 

2A 

l 

72 

58 

3A 

J 
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74 

4A 

z 
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90 

5A 

i 
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6A 

z 
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122 

7A 

11 
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VT 

13 

11 

B 
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33 

27 

IB 

+ 

53 

43 
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» 
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59 

3B 

K 
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C 
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k 

153 
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< 
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FF 
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12 

C 

FS 

34 

28 

1C 

> 
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3C 

L 

114 
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\ 
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92 

5C 
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6C 

1 
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7C 

13 
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CR 

15 

13 

D 

GS 

35 

29 

ID 

- 

55 

45 

2D 

s 

75 

61 

3D 

M 

115 

77 

4D 

] 
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93 

5D 

m 
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6D 

> 

175 

125 

7D 

14 
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SO 

16 

14 

E 

RS 

36 

30 

IE 

• 

56 

46 

2E 

> 

76 

62 

3E 

N 

116 

78 

4E 
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136 

94 

5E 

n 

156 

110 

6E 


176 

126 

7E 

15 

1111 

SI 

17 

15 

F 

US 

37 

31 

IF 

/ 

57 

47 

2F 

? 

77 

63 

3F 

O 

117 

79 

4F 

— 

137 

95 

5F 

o 

157 

111 

6F 

DEL 

177 

127 

7F 


KEY 


CHARACTER 

ESC 

33 


27 



IB 


OCTAL 

DECIMAL 

HEX 
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A.2 ASCII and DEC Multinational Character Set Tables 


The ASCII character set comprises the first half of the DEC Multinational 
Character Set. Table A-2 represents the second half of the DEC Multinational 
Character Set (characters with decimal values 128 through 255). The first half 
of each of the numbered columns identifies the character as you would see 
it on a VT300- or VT200-series terminal or printer (these characters cannot 
be output on a VTlOO-series terminal). Section A.3 describes how to enter 
symbols from the DEC Multinational Character Set. 
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A.2 ASCII and DEC Multinational Character Set Tables 


Table A-2 Graphical Representation of the DEC Multinational Extension to the ASCII 
Character Set 
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A.3 DEC Multinational Character Set 


A.3 




DEC Multinational Character Set 

The DEC Multinational Character Set is an 8-bit character set with 256 
characters; the first 128 characters in the set correspond to the ASCII character 
set. Each character has a value in the range 0 through 255 decimal. 

In Table A-3, the graphic symbols shown in parentheses represent ASCII 
control characters. These are produced on most terminals by pressing the key 
indicated while holding down the CONTROL key. On VT300- and VT200- 
series terminals, graphic symbols with decimal values greater than 127 can 
be entered using the compose sequences. Press the Compose Character key 
followed by the EDT symbol; the graphic symbol is then displayed on your 
terminal. On VT300- and VT200-series terminals, you can enter symbols for 
characters 128 through 255 either in EDT or at DCL level. 

On VT 100-series terminals, graphic symbols with decimal values greater than 
127 can only be entered from screen mode in EDT. Use the EDT keypad 
command SPECINS or the nokeypad command ASC to enter these characters 
in your text; EDT then displays the EDT symbol that corresponds to the 
character rather than displaying the graphic symbol itself. 
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A.3 DEC Multinational Character Set 

Table A-3 Abbreviations and Descriptions of the DEC Multinational Character Set 


Graphic 

EDT 

Symbol 

Decimal 

Value 

Abbrev. 

Description 

(C'» ) 

A (u 

0 

NUL 

null character 

(A) 

A A 

1 

SOH 

start of heading 

(B) 

A B 

2 

STX 

start of text 

(C) 

A C 

3 

ETX 

end of text 

(D) 

A D 

4 

EOT 

end of transmission 

(E) 

A E 

5 

ENQ 

enquiry 

(F) 

A F 

6 

ACK 

acknowledge 

(G) 

A G 

7 

BEL 

bell 

(H) 

A H 

8 

BS 

backspace 

(I) 


9 

HT 

horizontal tabulation 

(J) 

<LF> 

10 

LF 

line feed 

(K) 

< VT> 

11 

VT 

vertical tabulation 

(L) 

<FF> 

12 

FF 

form feed 

(M) 

<CR> 

13 

CR 

carriage return 

(N) 

A N 

14 

SO 

shift out 

(0) 

A 0 

15 

SI 

shift in 

(P) 

A P 

16 

DLE 

data link escape 

(Q) 

A Q 

17 

DC1 

device control 1 

(R) 

A R 

18 

DC2 

device control 2 

(S) 

A S 

19 

DC3 

device control 3 

(T) 


20 

DC4 

device control 4 

(U) 

A U 

21 

NAK 

negative acknowledge 

(V) 

A V 

22 

SYN 

synchronous idle 

(W) 

A W 

23 

ETB 

end of transmission block 

(X) 

A X 

24 

CAN 

cancel 

(Y) 

A Y 

25 

EM 

end of medium 

(Z) 

A Z 

26 

SUB 

substitute 

(1) 

< ESC > 

27 

ESC 

escape 

<\) 

A \ 

28 

FS 

file separator 

(1) 

A 1 

29 

GS 

group separator 

( A ) 

A A 

30 

RS 

record separator 

(__) 

A 

31 

US 

unit separator 



32 

SP 

space 

1 

| 

33 

? 

exclamation point 

n 

II 

34 

ii 

quotation marks (double quote) 

# 

# 

35 

# 

number sign 

$ 

$ 

36 

$ 

dollar sign 

7c 

r /c 

37 

r /c 

percent sign 

& 

& 

38 

& 

ampersand 



39 

’ 

apostrophe (single quote) 

( 

( 

40 

( 

opening parenthesis 

) 

) 

41 

) 

closing parenthesis 

* 

* 

42 

$ 

asterisk 

.+ 

+ 

43 

+ 

plus 

, 

, 

44 


comma 

- 

- 

45 

- 

hyphen or minus 



46 


period or decimal point 

/ 

/ 

47 

/ 

slash 
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A.3 DEC Multinational Character Set 

Table A-3 (Cont.) Abbreviations and Descriptions of the DEC Multinational Character Set 



EDT 

Decimal 



Graphic 

Symbol 

Value 

Abbrev. 

Description 

0 

0 

48 

0 

zero 

1 

1 

49 

1 

one 

2 

2 

50 

2 

two 

3 

3 

51 

3 

three 

4 

4 

52 

4 

four 

5 

5 

53 

5 

five 

6 

6 

54 

6 

six 

7 

7 

55 

7 

seven 

8 

8 

56 

8 

eight 

9 

9 

57 

9 

nine 



58 


colon 

J 

* 

59 

• 

semicolon 

< 

< 

60 

< 

less than 

= 

= 

61 

= 

equals 

> 

> 

62 

> 

greater than 

9 

9 

63 

9 

question mark 

(a 

Ot 

64 

(a 

commercial at 

A 

A 

65 

A 

uppercase A 

B 

B 

66 

B 

uppercase B 

C 

C 

67 

C 

uppercase C 

D 

D 

68 

D 

uppercase D 

E 

E 

69 

E 

uppercase E 

F 

F 

70 

F 

uppercase F 

G 

G 

71 

G 

uppercase G 

H 

H 

72 

H 

uppercase H 

I 

I 

73 

I 

uppercase I 

J 

J 

74 

J 

uppercase J 

K 

K 

75 

K 

uppercase K 

L 

L 

76 

L 

uppercase L 

M 

M 

77 

M 

uppercase M 

N 

N 

78 

N 

uppercase N 

0 

0 

79 

O 

uppercase O 

P 

P 

80 

P 

uppercase P 

Q 

Q 

81 

Q 

uppercase Q 

R 

R 

82 

R 

uppercase R 

S 

S 

83 

S 

uppercase S 

T 

T 

84 

T 

uppercase T 

U 

U 

85 

U 

uppercase U 

V 

V 

86 

V 

uppercase V 

W 

W 

87 

W 

uppercase W 

X 

X 

88 

X 

uppercase X 

Y 

Y 

89 

Y 

uppercase Y 

Z 

Z 

90 

Z 

uppercase Z 

c 

[ 

91 

[ 

opening bracket 

\ 

\ 

92 

\ 

back slash 

] 

] 

93 

] 

closing bracket 

A 

A 

94 

A 

circumflex 

— 

— 

95 

— 

underline (underscore) 
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A.3 DEC Multinational Character Set 


Table A-3 (Cont.) Abbreviations and Descriptions of the DEC Multinational Character Set 


EDT 

Graphic Symbol 

Decimal 

Value 

Abbrev. 

Description 

V 

V 

96 

V 

grave accent 

a 

a 

97 

a 

lowercase a 

b 

b 

98 

b 

lowercase b 

c 

c 

99 

c 

lowercase c 

d 

d 

100 

d 

lowercase d 

e 

e 

101 

e 

lowercase e 

f 

f 

102 

f 

lowercase f 

g 

g 

103 

g 

lowercase g 

h 

h 

104 

h 

lowercase h 

i 

i 

105 

i 

lowercase i 

j 

j 

106 

j 

lowercase j 

k 

k 

107 

k 

lowercase k 

1 

1 

108 

1 

lowercase 1 

m 

m 

109 

m 

lowercase m 

n 

n 

110 

n 

lowercase n 

0 

0 

111 

0 

lowercase o 

P 

P 

112 

P 

lowercase p 

q 

q 

113 

q 

lowercase q 

r 

r 

114 

r 

lowercase r 

s 

s 

115 

s 

lowercase s 

t 

t 

116 

t 

lowercase t 

u 

u 

117 

u 

lowercase u 

V 

V 

118 

V 

lowercase v 

w 

w 

119 

w 

lowercase w 

X 

X 

120 

X 

lowercase x 

y 

y 

121 

y 

lowercase y 

z 

z 

122 

z 

lowercase z 

{ 

< 

123 

I 

opening brace 

1 

1 

124 

1 

vertical line 

} 

} 

125 

1 

closing brace 

~ 

~ 

126 

~ 

tilde 

DEL 

<DEL> 

127 

DEL 

delete, rubout 


<X80> 

128 

... 

I reserved I 


<X81 > 

129 

... 

I reserved1 


<X82> 

130 

— 

1 reserved1 


<X83> 

131 

... 

I reserved I 


<IND> 

132 

IND 

index 


<NEL> 

133 

NEL 

next line 


<SSA> 

134 

SSA 

start of selected area 


<ESA> 

135 

ESA 

end of selected area 


<HTS> 

136 

HTS 

horizontal tab set 


<HTJ > 

137 

HTJ 

horizontal tab set with justification 


<VTS> 

138 

VTS 

vertical tab set 


<PLD> 

139 

PLD 

partial line down 


<PLU > 

140 

PLU 

partial line up 


<RI> 

141 

RI 

reverse index 


<SS2> 

142 

SS2 

single shift 2 


<SS3> 

143 

SS3 

single shift 3 
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Character Sets 

A.3 DEC Multinational Character Set 


Table A-3 (Cont.) Abbreviations and Descriptions of the DEC Multinational Character Set 


Graphic 

EDT 

Symbol 

Decimal 

Value 

Abbrev. 

Description 


<DCS> 

144 

DCS 

device control string 


<PU1> 

145 

PU1 

private use 1 


<PU2> 

146 

PU2 

private use 2 


<STS> 

147 

STS 

set transmit state 


<CCH> 

148 

CCH 

cancel character 


<MW > 

149 

MW 

message waiting 


<SPA> 

150 

SPA 

start of protected area 


<EPA> 

151 

EPA 

end of protected area 


<X98> 

152 

— 

| reserved I 


<X99> 

153 

— 

| reserved| 


<X9A> 

154 

... 

1 reserved I 


<CSI> 

155 

CS1 

control sequence introducer 


<ST> 

156 

ST 

string terminator 


<osc> 

157 

osc 

operating system command 


<PM> 

158 

PM 

privacy message 


<APC> 

159 

APC 

application program command 


<XA0> 

160 

— 

I reserved I 

i 

<!!> 

161 

i 

inverted exclamation mark 

<2 

<C/> 

162 

C 

cent sign 

£ 

<L-> 

163 

£ 

pound sign 


<XA4> 

164 

... 

| reserved I 

¥ 

<Y-> 

165 

¥ 

yen sign 


<XA6> 

166 

... 

I reserved I 

§ 

<so> 

167 

§ 

section sign 

X 

<xo> 

168 

X 

general currency sign 

6 

<co> 

169 

c 

copyright sign 

a_ 

<a_ > 

170 


feminine ordinal indicator 


< < < > 

171 


angle quotation mark left 


<XAC> 

172 

... 

1 reserved I 


<XAD> 

173 

... 

I reserved 1 


<XAE> 

174 

... 

I reserved I 


<XAF> 

175 

... 

I reserved I 

o 

<0 A > 

176 

o 

degree sign 

Hh 

< + -> 

177 


plus/minus sign 

2 

<2 A > 

178 

2 

superscript 2 

3 

<3 A > 

179 

M 

superscript 3 


<XB4> 

180 

... 

I reserved I 

M- 

</U> 

181 

M- 

micro sign 

f 

<P!> 

182 

i 

paragraph sign, pilcrow 

• 

< A > 

183 

• 

middle dot 


<XB8> 

184 

... 

I reserved I 

1 

<1 A > 

185 

l 

superscript 1 

0 

<o_> 

186 

0 

masculine ordinal indicator 


< > > > 

187 


angle quotation mark right 

Va 

< 14> 

188 

Va 

fraction one quarter 

V'i 

< 12> 

189 

Vi. 

fraction one half 


<XBE> 

190 

... 

1 reserved I 

6 

<??> 

191 

6 

inverted question mark 
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Character Sets 

A.3 DEC Multinational Character Set 

Table A-3 (Cont.) Abbreviations and Descriptions of the DEC Multinational Character Set 


EDT 

Graphic Symbol 

Decimal 

Value 

Abbrev. Description 

A 

<A > 

192 

A 

uppercase A with grave accent 

A 

<A > 

193 

A 

uppercase A with acute accent 

A 

< A~> 

194 

A 

uppercase A with circumflex 

A 

<A~> 

195 

A 

uppercase A with tilde 

A 

< A" > 

196 

A 

uppercase A with umlaut,(diaeresis) 

A 

<A*> 

197 

A 

uppercase A with ring 

JE 

< AE> 

198 

JE 

uppercase AE diphthong 

Q 

<C,> 

199 

Q 

uppercase C with cedilla 

E 

<E' > 

200 

E 

uppercase E with grave accent 

E 

<E> 

201 

E 

uppercase E with acute accent 

E 

<E~> 

202 

E 

uppercase E with circumflex 

E 

<E M > 

203 

E 

uppercase E with umlaut, (diaeresis) 

I 

<r> 

204 

I 

uppercase I with grave accent 

I 

<r> 

205 

I 

uppercase I with acute accent 

i 

<r> 

206 

i 

uppercase I with circumflex 

I 

<i» > 

207 

i 

uppercase I with umlaut, (diaeresis) 


<XD0> 

208 

— 

1 reserved1 

N 

<N~> 

209 

N 

uppercase N with tilde 

6 

<0> 

210 

O 

uppercase O with grave accent 

6 

<0> 

211 

6 

uppercase O with acute accent 

6 

<0~> 

212 

6 

uppercase O with circumflex 

6 

<0~> 

213 

0 

uppercase O with tilde 

0 

<0"> 

214 

0 

uppercase O with umlaut, (diaeresis) 

(E 

<OE> 

215 

(E 

uppercase OE ligature 

0 

<0/> 

216 

0 

uppercase O with slash 

u 

<u> 

217 

u 

uppercase U with grave accent 

u 

<u> 

218 

u 

uppercase U with acute accent 

u 

<ir> 

219 

u 

uppercase U with circumflex 

u 

<u u > 

220 

u 

uppercase U with umlaut, (diaeresis) 

Y 

< Y M > 

221 

Y 

uppercase Y with umlaut, (diaeresis) 


<XDE> 

222 

— 

1 reserved1 

6 

<ss> 

223 

B 

German lowercase sharp s 

a 

<a> 

224 

a 

lowercase a with grave accent 

a 

<a > 

225 

a 

lowercase a with acute accent 

a 

<a~> 

226 

a 

lowercase a with circumflex 

a 

<a~> 

227 

a 

lowercase a with tilde 

a 

<a"> 

228 

a 

lowercase a with umlaut, (diaeresis) 

a 

<a*> 

229 

a 

lowercase a with ring 

ae 

<ae> 

230 

ae 

lowercase ae diphthong 

S 

<c,> 

231 

Q 

lowercase c with cedilla 

e 

<e > 

232 

e 

lowercase e with grave accent 

e 

<e> 

233 

e 

lowercase e with acute accent 

e 

<e~> 

234 

e 

lowercase e with circumflex 

e 

<e M > 

235 

e 

lowercase e with umlaut, (diaeresis) 

i 

<i> 

236 

i 

lowercase i with grave accent 

i 

<i> 

237 

i 

lowercase i with acute accent 

l 

<i*> 

238 

i 

lowercase i with circumflex 

i 

< i •• > 

239 

i 

lowercase i with umlaut, (diaeresis) 
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Character Sets 

A.3 DEC Multinational Character Set 


Table A-3 (Cont.) Abbreviations and Descriptions of the DEC Multinational Character Set 


EDT Decimal 

Graphic Symbol Value Abbrev. Description 



<XF0> 

240 

— 

n 

<n~> 

241 

n 

6 

A 

o, 

V 

242 

6 

6 

< 0 > 

243 

6 

6 

A 

o 

> 

V 

244 

6 

6 

<0~> 

245 

6 

6 

<o"> 

246 

6 

oe 

<oe> 

247 

oe 

0 

< 0/ > 

248 

0 

ii 

<u> 

249 

ii 

u 

< u > 

250 

u 

u 

<u~> 

251 

u 

ii 

<U M > 

252 

ii 

y 

<y M > 

253 

y 


<XFE> 

254 

— 


<XFF> 

255 



[reserved] 

lowercase n with tilde 
lowercase o with grave accent 
lowercase o with acute accent 
lowercase o with circumflex 
lowercase o with tilde 
lowercase o with umlaut, (diaeresis) 
lowercase oe ligature 
lowercase o with slash 
lowercase u with grave accent 
lowercase u with acute accent 
lowercase u with circumflex 
lowercase u with umlaut, (diaeresis) 
lowercase y with umlaut, (diaeresis) 
[reserved] 

[reserved] 
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Expressions 



The following table lists data operations and comparisons in order of 
precedence, beginning with the highest: 


Operator 

Precedence 

Description 

+ 

1 

Indicates a positive number 

- 

1 

Indicates a negative number 

* 

2 

Multiplies two numbers 

/ 

2 

Divides two numbers 

+ 

3 

(1) Adds two numbers (2) Concatenates two 
character strings 

- 

3 

(1) Subtracts two numbers (2) Subtracts two 
character strings 

.EQS. 

4 

Tests if two character strings are equal 

.GES. 

4 

Tests if first character string is greater than or 
equal 

.GTS. 

4 

Tests if first character string is greater than 

.LES. 

4 

Tests if first character string is less than or equal 

.LTS. 

4 

Tests if first character string is less than 

.NES. 

4 

Tests if two character strings are not equal 

.EQ. 

4 

Tests if two numbers are equal 

.GE. 

4 

Tests if first number is greater than or equal to 

.GT. 

4 

Tests if first number is greater than 

.LE. 

4 

Tests if first number is less than or equal to 

.LT. 

4 

Tests if first number is less than 

.NE. 

4 

Tests if two numbers are not equal 

.NOT. 

5 

Logically negates a number 

.AND. 

6 

Combines two numbers with a logical AND 

.OR. 

7 

Combines two numbers with a logical OR 


The following tables demonstrate the results of logical operations on a bit- 
by-bit basis and a number-by-number basis. In logical operations, a character 
string beginning with an uppercase or lowercase T or Y is treated as the 
number 1; a character string beginning with any other character is treated as 
the number 0. In logical operations, odd numbers are considered true and 
even numbers and zero are considered false. 


B—1 










Expressions 


Given 

Bit A 

Bit B 

Results 
.NOT A 

A .AND. B 

A .OR. B 

1 

1 

0 

1 

1 

1 

0 

0 

0 

1 

0 

1 

1 

0 

1 

0 

0 

1 

0 

0 


Given 
Number A 

Number B 

Results 
.NOT A 

A .AND. B 

A .OR. B 

odd 

odd 

even 

odd 

odd 

odd 

even 

even 

even 

odd 

even 

odd 

odd 

even 

odd 

even 

even 

odd 

even 

even 
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A 


Absolute time 

combined with delta time* 1-16 
default values* 1-15 
examples* 1-15 
rules for entering* 1-15 
syntax* 1-15 
Access 

object • 7-3 
Access control list 
See ACL 

Access Control List Editor 
See ACL editor 
Access control list entry 
See ACE 

Access control string 

copying files between nodes with *2-16 
definition *2-11 
example *2-11 
in a logical node name *4-16 
rules for entering *2-11 
Access mode 

and the DEFINE command *4-13 
for a logical name *4-13 
for a logical name table *4-13 
using qualifiers to specify *4-13 
ACE (access control list entry) 

ALARM_IOURNAL • 7-9 

creating • 7-7 

DEFAULT_PROTECTION • 7-9 
deleting *7-14 
IDENTIFIER *7-8 
processing *7-18 
replacing *7-14 
ACL (access control list) 
copying *7-14 
default protection *7-10 
definition *7-1, 7-5 

displaying with SHOW ACL command *7-12 

editing with EDIT/ACL command *7-15 

entries in • 7-7 

identifier *7-6 

modifying *7-14 

protecting files with • 7-5 


ACL (access control list) (cont'd.) 

specifying with SET ACL command (DCL) • 

7-13 

ACL editor 

deleting text with *7-18 

invoking with EDIT/ACL command *7-15 

keypad *7-15 

moving the cursor with *7-17 
restoring text with *7-18 
Address sort* 1-39 
ADVANCE command (EDT)*8-58 
ALARM-JOURNAL access control list entry *7-9 
ACCESS field *7-9 
Allocate access category 
definition • 7-4 

ALLOCATE command (DCL) *2-10 
.APPENDIX command (DSR)*9-14 
Arrow key 

See Down arrow key. Left arrow key. Right 
arrow key. Up arrow key 

ASCII 

collating sequence* 1-39 
ASCII Character Set* A-1 
ASSIGN command (DCL) • 4-2 
Assignment statement 

creating a blank line with *5-17 
creating a global symbol with *5-3 
creating a local symbol with • 5-3 
formatting output records with *5-17 
for numeric overlay *5-17 
including an asterisk in • 5-4 
including a symbol as part of a character string • 
5-11 

syntax • 5-2 

for numeric overlay *5-16 
for string overlay *5-16 
Asterisk (*) wildcard character 
in directory specifications *2-14 
rules for using *2-14 
ATTACH command (DCL)* 1-21, 3-6 
Authorize Utility (AUTHORIZE)*7-1 
Automatic login* 1-3 


B 


BACKSPACE key* 1-18 
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BACKUP command (EDT) • 8-58 
Batch job 

definition • 3-8 
job number of • 3-8 
log file *3-9 
output *3-9 

passing parameters to*6-7, 6-8 
restarting *3-9, 6-32 
submitting • 3-8 

submitting command procedure as* 1-6, 3-4 
submitting program as* 1-6 
submitting sort operation as* 1-41 
Batch mode 
definition* 1-6 
Bit 

definition *5-1 

BOTTOM command (EDT)*8-57 
BOTTOM command (EVE) *8-9 
Buffer 

definition • 8-2 

EDT commands for using *8-69 
EVE commands for using *8-31 to 8-33 
MAIN *8-69 
PASTE *8-66 
reading file into 
with EDT • 8-69 
with EVE *8-34 
writing 

with EDT • 8-69 
with EVE *8-34 

BUFFER command (EVE) *8-9, 8-31 
Built-in command 
definition* 1-6 

interrupting and canceling • 1 -20 to 1-21 
Built-In command 

table of DCL built-in commands* 1-7 
Byte 

definition *5-1 


c 


CALL command (DCL) *6-26 
CAPITALIZE command (EVE) *8-30 
CAPITALIZE WORD command (EVE) *8-36 
Carriage control 
types of *2-5 

CENTER LINE command (EVE) *8-30, 8-36 
CHANGE command (EDT) *8-52 
.CHAPTER command (DSR)*9-14 


Character data 

See also Character string 
alphanumeric *5-7 
expression *5-12 
nonprintable*5-8 
special *5-8 
Character set 
ASCII* A-1 

DEC Multinational* A-5 
Character string • 5-7 

comparison operators in expression*5-11 

concatenation *5-12 

creating *5-8 

evaluation of *5-3 

expression *5-12 

multiple string values in an expression *5-12 
passing to command procedure *6-7 
reduction *5-12 
substring replacement in *5-16 
symbol substitution in • 5-6 
used as symbol *5-2 
values stored in *5-7 
CHAR command (EDT) *8-54, 8-63 
CLOSE command (DCL) *6-14 
Collating sequence 
ASCII* 1-39 
EBCDIC* 1-39 
multinational* 1-40 
Combination time 
examples* 1-16 
rules for entering* 1-16 
syntax* 1-16 
Command 

See also Command procedure 
See also Foreign command 
abbreviating* 1-10 

in command procedures* 1-10 
in HELP* 1-7 
built-in* 1-6 

canceling *1-11, 1 -20, 1 -21 
DCL command line syntax* 1-8 
executing* 1-19 
interrupting • 1 -20 to 1-21 
rules for entering* 1-10 
types* 1-6 
Command file 
EDT*8-71 
Command image 

definition* 1-6, 1-20, 3-4 
interrupting and canceling • 1 -20 to 1-21 
privileged and nonprivileged • 1-20 
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Index 


Command level 
definition • 1 -2 
nesting *6-3 
Command line 

continuation over multiple lines* 1-10 
editing 

enabling* 1-22 
in insert mode* 1-23 
in overstrike mode* 1-23 
list of keys for* 1-17 to 1-19 
parts of • 1-8 
recalling* 1-21 to 1-22 
syntax • 1 -8 
terminators* 1-19 
Command procedure 
and file 1/0*6-13 
case statement in • 6-23 
cleanup *6-33 
comments in* 1-29, 6-1 
creating global symbol in *6-11 
data line in • 6-6 
debugging *6-27, 6-28 
definition • 3-4, 6-1 
directing output to terminal *6-12 
error handling • 6-30 
executing 

interactively *6-2 
on remote node • 6-2 
exiting • 6-4 
format *6-1 
I/O errors in *6-18 
input *6-6 

from file *6-10 
from terminal *6-10 
interrupting with CTRL/Y • 6-32 
invoking within a command procedure *6-2 
loop in *6-24 
nested • 6-3 

passing character string to *6-7 

passing data to • 6-6 

passing parameters to *5-3, 6-7 

passing symbols to *6-7 

redirecting output *6-11 

returning status value in • 6-4 

SET DEFAULT command (DCL) in *6-13 

submitting as batch job *3-8 

subroutines in *6-25 

using stubs in *6-27 

using TYPE command to execute *6-2 

variables in *6-19 

writing file from a *6-13 


Command qualifier* 1-12 
definition* 1-12 
rules for entering* 1-12 
Command values 

date and time formats* 1-14 
Comment 

in a command procedure* 1-29, 6-1 
CONTINUE command (DCL)* 1-21, 3-5 
CONTINUE command (EDT)*8-54 
Controller designation field 
default value *2-10 
definition • 2-9 
COPY command (DCL) *2-16 
printing DSR output with • 9-20 
COPY command (MAIL)* 1-33 
CREATE command (DCL) *2-16 
CREATE/DIRECTORY command (DCL) *2-21, 
7-11 

CREATE/NAME_TABLE command (DCL) *4-14 
CTRL/B 

recalling commands with* 1-18, 1-21 
CTRL/C 

See also CTRL/Y 

and corrupted EVE journal file *8-24 
canceling a MAIL message with* 1-28 
canceling EDT command with *8-51 
interrupting or canceling DCL commands with* 
1-17, 1-20, 1-21 
CTRL/T 

enabling* 1-20 

interrupting DCL commands with* 1-18, 1-20 
CTRL/W 

refreshing screen display in EDT with *8-53 
refreshing screen display in EVE with • 8-23 
refreshing screen display with* 1-18, 3-5 
CTRL/Y 

See also CTRL/C 

aborting remote session with* 1-4 
interrupting a command procedure with • 6-30, 
6-32 

interrupting an EDT editing session with *8-54 
interrupting an image with *3-5 
interrupting or canceling DCL commands with* 
1-18, 1-20, 1-21 
CTRL/Z 

as command line terminator* 1-19 
as end-of-file terminator* 1-17, 2-16 
sending a file in MAIL with* 1-28 
sending a MAIL message with* 1-28 
writing a file in EDT with • 8-48 
writing a file in EVE with *8-3 
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CTRL keys*1-17 to 1-19 
Cursor control 

In EDT *8-54, 8-58 
in EVE • 8-8 

CUT command (EDT) • 8-65 


D 


Data 

logical *5-10, 5-15 
numeric *5-8, 5-13 
passing to command procedure • 6-6 
storing *5-1 
Data type • 2-4 
Date 

See also Absolute time 
See also Combination time 
See also Delta time 

specifying absolute and delta date and time 
combinations* 1-16 
specifying absolute date and time* 1-15 
specifying delta date and time* 1-16 
DCL (DIGITAL Command Language) 
definition* 1-1 
using* 1-6 
DCL command* 1-6 

executing within EVE • 8-46 
interrupting or canceling 

with CTRL/C *1-17,1-20, 1-21 
with CTRL/Y *1-18,1 -20, 1 -21 
interrupting with CTRL/T *1-18, 1-20 
recalling 

with CTRL/B* 1-18 
with Down arrow key* 1-18 
with Up arrow key* 1-18 
DCL command level 
definition* 1-2 
DCL prompt ($)• 1-2, 1-6 
DEASSIGN command (DCL) *4-5 
and process logical name table • 4-5 
DECK command (DCL) • 6-6 
DEC Multinational Character Set • A-5 
DECnet 

See also Network 

logging in to remote systems with* 1-3 
DECnet-VAX 

access violation *2-16 
and logical node name *4-16 
file manipulation with *2-16 


Default protection *7-5, 7-10 
Default values 

in file specifications *2-12 
provided by system* 1-11 
DEFAULT_PROTECTION access control list entry 
7-9 

DEFINE command (DCL) *4-2 

and process logical name table *4-5 
example with access mode qualifier *4-13 
specifying the access mode with *4-13 
DEFINE/KEY command (DCL)* 1-24 
DEFINE KEY command (EDT) *8-71, 8-73 
DEFINE KEY command (EVE) *8-39 
DEFINE/KEY command (MAIL)* 1-35 
DEFINE MACRO command (EDT) *8-74 
DEL C command (EDT) • 8-59 
DEL EOL command (EDT) *8-61 
Delete access category 
definition *7-4 

DELETE BUFFER command (EVE) *8-31, 8-32 
DELETE command (DCL) *2-17 
and wildcard characters *2-17 
DELETE command (MAIL)* 1-32 
DELETE key* 1-18 
DELETE KEY command* 1-26 
DELETE/SYMBOL command (DCL) *5-5 
DELETE WINDOW command (EVE) *8-35 
DEL L command (EDT) *8-61 
Delta time 

combined with absolute time* 1-16 
default values* 1-16 
examples* 1-16 
rules for entering* 1-16 
syntax* 1-16 

DEL W command (EDT) *8-60 
Detached process 
batch job as • 3-8 
creating with unique UIC*7-3 
definition *3-1 
Device *2-1, 2-8 

default name designation *2-10 
mass storage • 2-8 
nonfile *7-12 
record oriented • 2-8 
setting default to another* 2-23 
unit record • 2-8 
Device code 
definition • 2-9 
Device field 

default value *2-12 

in full file specification *2-11 
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Index 


Device name 

See also Device field 
See also Physical device name 
concealed *4-13 
generic *2-10 

logical name equated to •2-10 
rules for entering • 2-9 
Device protection*7-12 
Dialing in* 1-4 
DIGITAL Command Language 
See DCL 

DIGITAL Standard Runoff 
See DSR 

DIRECTORY command (DCL) • 2-20, 7-12 
DIRECTORY command (MAIL)* 1-31, 1-33 
Directory field 

default value *2-12 
in full file specification *2-11 
using an asterisk wildcard character in *2-14 
using a percent sign wildcard character in • 
2-15 
Directory file 

See also Directory structure 
creating • 2-21 
default *2-6, 2-22 
definition • 2-6 
deleting • 2-21 
login • 2-6 
named format • 2-8 
protection *7-11 
setting default to another *2-22 
top level*2-1, 2-6 
Directory name 

named format in a file specification • 2-8 
replacing 

with the ellipsis (...) wildcard character* 
2-23 

with the hyphen (-) wildcard character* 
2-24 

Directory structure *2-1 
duplicating 

with BACKUP command *2-25 
with wildcard characters • 2-25 
master file directory in *2-1, 2-6 
sample *2-7 
subdirectory in • 2-6 
top level directory in *2-1, 2-6 
user file directory in *2-1, 2-6 
Disk *2-8 

See also Device 
contents of *2-6, 2-8 


Disk (cont'd.) 

protection *7-11 
Distribution list 

creating in MAIL* 1-29 
DO key 

on VT200- and VT300-series terminals *8-4 
using *8-6 
Down arrow key 

recalling commands with* 1-18, 1-21 
DSR (DIGITAL Standard Runoff) 

adjusting page numbers with *9-13 
adjusting running heads with *9-13, 9-16 
centering text with • 9-5 
creating bolded text with *9-12 
creating section heads with *9-14 
flags *9-1 

formatting footnotes with *9-12 
formatting literal text with • 9-7 
formatting notes with *9-11 
formatting paragraphs with • 9-6 
indenting text with • 9-5 
justifying text with • 9-4 
output file • 9-3 
printing • 9-20 

processing source file with *9-17 
producing an index with *9-18 
producing table of contents with *9-17 
source file *9-1 

suspending page numbers with *9-17 
underlining text with *9-12 
DSR commands 
abbreviating *9-1 

DSR Table of Contents Utility *9-17 


E 


EBCDIC 

collating sequence* 1-39 
EDIT/ACL command (DCL) *7-15 
EDIT command (DCL) • 8-47 
EDIT/EDT command (DCL) 

/READ-ONLY qualifier to • 2-15 
Editing session 

exiting from EDT • 8-48 
exiting from EVE • 8-3 

recovering EDT after system interruption • 8-54 
recovering EVE after system interruption • 8-23 
refreshing screen display during EDT • 8-53 
refreshing screen display during EVE • 8-23 
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EDIT/TPU command (DCL) • 8-2 
/READ-ONLY *2-15 
EDT editor 

as default MAIL editor* 1-35 
buffer 

commands for using • 8-69 to 8-71 
definition • 8-47 
changing modes in *8-52 
creating startup file for *8-71 
cursor control in *8-54, 8-58 
defining macros in *8-74 
displaying a file with *8-48 
exiting from • 8-48 
invoking *8-47 
key definitions 

assigning *8-71, 8-73 
keypad commands *8-49 
line-editing commands *8-48, 8-52 
reading a file with *8-69 
recovering session after system interruption • 
8-54 

replacing text with • 8-64 
setting screen display in *8-72 
writing text to a file with • 8-69 
EDTINI.EDT file*8-71 
EDT keypad option 
using in EVE *8-23 
Ellipsis (...) wildcard character 

in a directory name *2-23 to 2-24 
END OF LINE command (EVE) *8-9 
ENDSUBROUTINE command (DCL) *6-26 
ENLARGE WINDOW command (EVE) *8-35 
ENTER command (EDT) *8-53 
EOB (End-of-buffer) symbol • 8-47 
EOD command (DCL) • 6-6 
EOL command (EDT) *8-55 
Equivalence name 
definition *4-1 

ERASE CHARACTER command (EVE) *8-13 
ERASE LINE command (EVE) *8-13 
ERASE PREVIOUS WORD command (EVE) *8-13 
Error handling 

in command procedures *6-30 
Error message 
format* 1-19 
EVE editor 

adjusting margins with *8-26 
as default MAIL editor* 1-35 
buffer 

commands for using *8-31 to 8-33 
definition • 8-2 


EVE editor 

buffer (cont'd.) 

reading file into *8-34 
writing *8-34 
centering text with *8-30 
changing case of text with *8-30 
cursor control in *8-8 
editing modes *8-7 
entering commands in *8-6 
exiting from *8-3 
filling text in *8-29 
formatting text with • 8-24 
in insert mode *8-11 
in overstrike mode *8-11 
key definitions 

assigning *8-39 to 8-40, 8-40,8-41 
removing • 8-40 
keypad diagram 

for VT 100-series terminal *8-6 
for VT200- and VT300-series terminals* 
8-4 

marking locations in *8-19 
reading batch job log file with *3-9 
recovering session after system interruption • 
8-23 

replacing text with • 8-20 
spawning out of *8-46 
window 

commands for using *8-35 
definition • 8-2 
Executable image 
See Image 

Execute access category 
definition • 7-4 
Execute procedure (@) 

executing command procedure interactively 
with • 6-2 

executing EVE initialization file with *8-44 
executing nested command procedure with* 
6-26 

EXIT command (DCL)* 1-21, 6-4 
EXIT command (EDT) *8-48 
EXIT command (EVE) *8-3 
Expression 

character *5-12 
definition *5-11 
logical *5-15 
numeric *5-13 

rules for determining the value of*5-'IB 
string comparison operators*5-11 
summary of operators*5-18 
EXTRACT command (MAIL)* 1-31 
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F 


F$ELEMENT lexical function*6-25 
FSENVIRONMENT lexical function *6-34 
F$EXTRACT lexical function • 6-24, 6-29 
F$GETJPI lexical function *6-33 
FSSEARCH lexical function *6-14 
F6 through F14 keys* 1-17 to 1-19 
File 

See also Directory file 
carriage control in • 2-5 
copying *2-16 

between nodes *2-16 
with access control string *2-19 
creating in command procedure *6-13 
definition *2-1 

editing in command procedure *6-15 
merging* 1-42 

and sequence checking* 1-42 
merging multiple* 1-37 
open file quota *6-33 
operations over the network *2-14 
purging *2-17 

reading from command procedure *6-15 
renaming *2-17 
sorting* 1-37 

writing in command procedure *6-13 
File access 

and ownership categories*7-4 
on a disk volume set *2-9 
on a tape volume set *2-9 
File characteristics • 2-4 to 2-5 
record • 2-4 
size • 2-5 

FILE command (MAIL)* 1-33 
File name 

See also File name field 
definition *2-2 
rules for entering • 2-2 
valid characters in *2-2 
File name field 

default value *2-12 
in full file specification *2-11 
using an asterisk wildcard character in *2-14 
using a percent sign wildcard character in* 
2-15 

File organization 
See Indexed file 
See Relative file 
See Sequential file 


File organization (cont'd.) 

specifying output from sort/merge operation • 
1-41 

File protection *7-9 
See also Protection 
File specification 

See also Wildcard character 
as a search list *4-15 
default values 

created by logical name translation *4-13 
in output file specification *2-13 
device field in *2-11 
directory field in *2-11 
example *2-11 
file name field in *2-11 
file type field in *2-11 
file version number field in *2-11 
foreign *2-12 
format *2-11 
in parameter list *2-13 
logical name in *4-1 
node field in *2-11 
node name in • 2-11, 2-16 
File type 

definition • 2-2 
list of default *2-2 
rules for entering • 2-2 
File type field 

asterisk wildcard character in *2-14 
default values *2-12 
default values created by logical name 
translation* 4-13 
in full file specification *2-11 
using a percent sign wildcard character in* 
2-15 

File version number 
definition *2-3 
File version number field 
default values *2-12 
in full file specification *2-11 
using an asterisk wildcard character in *2-14 
FILL command (EDT)*8-67 / 8-68 
FILL command (EVE) *8-29, 8-36 
FILL PARAGRAPH command (EVE) *8-29, 8-36 
FILL RANGE command (EVE) *8-36 
FIND command (EDT)*8-62 
Find key 

on VT200- and VT300-series terminals *8-17 
VT100 terminal equivalent of *8-17 
Flag 

in DSR source file *9-1 
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FNDNXT command (EDT) *8-63 
Footnote 

formatting in DSR*9-12 
Foreign command *5-1 
definition* 1-7 
Foreign file specification 
on a network *2-12 
Form feed 

in DSR output • 9-20 
FORTRAN carriage control • 2-5 
Function keys • 1 -17 to 1-19 



HELP command (EVE) *8-22 
HELP command (MAIL)* 1-27 
HELP command (PHONE)* 1-36 
HELP facility 
EDT *8-51 
EVE*8-22 

in interactive utilities* 1-8 
Hyphen 

and command line continuation* 1-10 
Hyphen (-) wildcard character 

in a directory name *2-24 to 2-25 



i 


Generic device name 
definition *2-10 
Generic queue 
definition *2-18 

GET FILE command (EVE) *8-9, 8-31, 8-34 
Global symbol 

command levels available to • 5-3 
creating in command procedure *6-11 
Global symbol table 

DCL reserved symbols • 5-4 
definition • 5-3 
search order *5-5 
GOLD key *8-41 
in EDT *8-49 
in EVE *8-41 

GOSUB command (DCL) • 6-25 
GOTO command (DCL) *6-22 
GO TO command (EVE) *8-19, 8-31 
Graphic symbol 

VT100 terminals • A-5 
VT200 terminals* A-5 
VT300 terminals* A-5 
Group logical name table 
definition • 4-7 
logical name for *4-7 
Group number 

in user identification code *7-2 
Group ownership category *7-3 


H 


HELP command (DCL)* 1-7 
HELP command (EDT) *8-51 


I/O error 

in command procedures *6-18 
Identifier 

definition *7-6 

IDENTIFIER access control list entry *7-8 

IF command (DCL) • 6-21 

Image 

See also Command image 
definition *3-1, 3-3 
noncommand • 3-4 
See also Foreign command* 1-7 
INCLUDE command (EDT) *8-69 
INCLUDE FILE command (EVE) *8-11, 8-34 
Index 

producing with DSR *9-18 
Indexed file *2-4 

and Sort/Merge Utility* 1-41 
Indexed sort* 1-39 
Initialization file 

defining keys in EVE *8-39 
editing-environment commands in *8-44 
invoking EVE with *8-44 
Input stream 
definition • 4-6 

INQUIRE command (DCL) *5-5, 6-9 
INSERT HERE command (EVE) *8-15 
Insert mode 

editing command line in* 1-23 
using EVE in *8-11 

INSERT PAGE BREAK command (EVE) *8-36 
Integer 

See Number 
Interactive mode 
definition* 1-6 
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Interactive utility 
See Utility 
Iterative translation 

See also Logical name translation 
and SHOW LOGICAL command®4-4 
and SHOW TRANSLATION command®4-4 
definition • 4-4, 4-12 
preventing® 4-13 


Key state (cont'd.) 

changing® 1-25 
Keyword 

definition® 1-9 


L 


j 


Job logical name 
definition • 4-6 
in a job tree • 4-6 
Job logical name table 

list of default contents of®4-6 
logical name for®4-6 
Job tree®3-5 
definition • 4-5 
Journal file 
EDT ®8-54 
EVE®8-23 


K 


Key 

See also Key definition 
function® 1-17 to 1-19 
sort® 1-38 
Key definition 

assigning® 1-24, 1-25 
in EDT®8-71 
in EVE®8-39 
deleting® 1-26 
displaying® 1-26 
list of definable keys® 1-24 
Keypad 

ACL editor diagram • 7-15 
displaying EDT keypad in EVE®8-23 
displaying EVE keypad®8-23 
displaying WPS keypad in EVE®8-23 
EDT® 8-49 
EVE 

on VT 100-series terminal®8-6 
on VT200- and VT300-series terminals® 
8-6 

MAIL diagram® 1-35 
Key state® 1-25 


Label 

definition® 1-9 
in DCL command line® 1-8 
Learn sequence 
defining • 8-40 
Left arrow key 

moving cursor with® 1-18 
Lexical function 

and logical name translation®4-4 
definition • 5-9 
evaluating® 5-10 
invoking® 5-9 

list of functions used to save and restore 
process characteristics® 6-34 
symbol substitution in • 5-6 
syntax® 5-9 

using in command procedure®5-9, 6-12 
LINE command (EDT)®8-56 
LINE command (EVE)®8-9 
Line editing 

See Command line 
LINEFEED key® 1-18 
Line terminators® 1-19 
LINK command (DCL)®4-13 
List 

formatting with DSR • 9-8 
LNM$GROUP • 4-7 
LNM$JOB • 4-6 
LNM$PROCESS • 4-5 
LNM$PROCESS_DIRECTORY • 4-9 
LNM$SYSTEM • 4-7 
LNM$SYSTEM_DIRECTORY • 4-9 
Local node 

copying files from remote node to®2-14 
definition® 1-3 

displaying remote files from®2-11 
Local symbol • 5-2 
Local symbol table 
definition • 5-3 
PI through P8®5-3 
search order® 5-5 
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Log file 

for batch job *3-9 
Logical name 

See also Job logical name 

See also Logical name table 

See also Process logical name 

access mode*4-13 

as device name *2-10 

concealed device name *4-13 

defined as a search list *4-15 

defining *4-2 

displaying *4-4 

equivalence name *4-1 

for a mounted disk or tape *4-6 

for a network *4-16 

for a node specification •4-16 

overview • 4-1 

preventing definition in subprocesses *3-8 
process-permanent *4-17 
rules for creating • 4-2 
search lists *4-15 
system-created *4-17 
system-permanent • 4-20 
translation in file specifications *4-2 
Logical name directory table 
definition *4-9 
process • 4-9 
system *4-10 
Logical name table 

See also Group logical name table 
See also Job logical name table 
See also Process logical name table 
See also System logical name table 
creating *4-14 
defining access mode *4-13 
definition • 4-5 
deleting *4-14 
list of system-provided *4-1 
process-private • 4-5 
search order *4-5, 4-12 
shareable *4-6 
definition *4-5 
Logical name translation 
and wildcards *4-15 
default search order *4-11 
default values *4-13 
in file specifications *4-13 
iterative *4-12 

preventing iterative translation *4-13 
Logical operators *5-12 


Login 

automatic* 1-3 
dial in* 1-4 
manual* 1-1 
network* 1-3 
LOGIN.COM 

See Login command procedure 
Login command procedure 
personal *6-4 

defining EVE$INIT in *8-44 
defining keys in* 1-25 
defining logical names in *4-1 
defining symbols in* 1-24 
definition* 1-3, 6-4 
executed as batch jobs • 3-9 
location of *6-4 
sample *6-4 

specifying alternate file specification • 6-6 
system* 1-2 

Login directory file *2-1, 2-6 
Logout* 1-5 
network • 1 -4 

LOGOUT command (DCL)* 1-5, 3-6 
Longword 

definition *5-1 

LOWERCASE command (EVE) *8-30 
LOWERCASE WORD command (EVE) *8-36 
Low-order unit 
definition *5-1 


M 


MAIL command (DCL)* 1-27 
MAIL folder 
creating* 1-33 
deleting* 1-34 
displaying list of* 1-33 
MAIL* 1-31, 1-32 
NEWM AIL *1-30, 1-32 
selecting* 1-33 
WASTEBASKET* 1-32 
Mail subdirectory 
creating* 1-27 
Mail Utility (MAIL) 

creating mail files* 1-34 
deleting a message in* 1-32 
exiting* 1-27 

extracting a message to a file with* 1-31 
invoking* 1-27 
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P 






Mail Utility (MAIL) (cont'd.) 
keypad 

commands* 1-34 
diagram* 1-35 
protecting mail files in *7-11 
reading a message in* 1-30 to 1-31 
sending a file from DCL level with* 1-29 
sending a file in MAIL with* 1-28, 2-16 
sending a message over network with* 1-28 
sending a message to a distribution list with* 
1-29 

setting default editor in* 1-35 
using text editor in* 1-28 
Margin adjustment 
DSR*9-5 

MARK command (EVE) *8-19 
Mass storage device 
definition • 2-8 
Master file directory 
See MFD 
Member number 

in user identification code *7-2 
MERGE command (DCL)* 1-37, 1-42 
See also Sort/Merge Utility 
MFD (master file directory) • 2-1, 2-6 
See also Directory structure 
displaying contents of *2-21 
Modem (or data set)* 1-4 
MOUNT command (DCL) *2-10, 7-11 
MOVE BY PAGE command (EVE) *8-9 
MOVE BY WORD command (EVE) *8-9 
MOVE command (MAIL)* 1-33 
Multinational collating sequence* 1-40 


N 


Named directory specification 
definition • 2-8 

format in a file specification • 2-8 
rules for entering • 2-8 
Network 

executing programs across *3-4 
link* 1-4 
login* 1-3 
logout* 1-4 

sending mail over* 1-28 
Network file specification 
See File specification 


Network node 

See also Access control string 
See also Node name 
accessing a local node *2-11 
accessing a remote node *2-11 
NEXT WINDOW command (EVE) *8-9, 8-35 
Node field 

default value *2-12 
in full file specification *2-11 
Node name 

See also Access control string 
See also Node field 
definition *2-11 

format in a file specification *2-11 
rules for entering *2-11 
using a logical name *4-16 
Noncommand image *3-4 
Nonfile device 
protection *7-12 
Nonprivileged command image 

interrupting and canceling* 1-20 to 1-21 
Number 

as fraction • 5-9 

assigning to a symbol *5-8 

converting to a string value *5-15 

evaluation of *5-3 

in an expression*5-13 

integer values recognized by DCL *5-8 

internal storage of *5-9 


o 


Offset 

definition *5-16 
ON command (DCL) *6-30 

ON CONTROI_Y command (DCL) *6-31 

ONE WINDOW command (EVE) *8-35 
OPEN command (DCL) *6-13 
OPEN LINE command (EDT)*8-56 
Operator 

character string *5-12 
concatenation *5-12 
definition *5-11 
logical *5-12, 5-15 
numeric *5-13 
order of evaluation*5-18 
reduction *5-12 
string comparison *5-11 
OTHER WINDOW command (EVE) *8-35 
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Output stream 
definition • 4-6 

Overlay, numeric*5-16, 5-17 
Overstrike mode 

editing command line in* 1-23 
using EVE in *8-11 
Owner ownership category • 7-3 
Ownership 

displaying file *7-12 
object • 7-3 


p 


PI through P8*5-3 
PAGE command (EDT)*8-57 
Page number 

adjusting with DSR*9-13 
suspending with DSR*9-17 
Paragraph 

formatting with DSR • 9-6 
Parameter 

definition* 1-9 
in DCL command line* 1-8 
in file specification *2-13 
passing to a command procedure *5-3, 6-7 
rules for entering* 1-11 
syntax* 1-11 
Parameter list 
syntax* 1-12 
Parameter qualifier 
definition* 1-13 
Parent process 
definition *3-1 
Password 

changing* 1-2 
creating* 1-2 

in access control string *2-11 
in command procedure* 1-4 
in file* 1-4 

PASTE command (EDT)*8-65 
Percent sign (%) wildcard character 
rules for using *2-15 
PF1 key 

on VT 100-series terminals*8-17 
Phone Utility (PHONE)* 1-36 
Physical device name 

controller designation field *2-9 
device code field *2-9 
format in a file specification • 2-9 


Physical device name (cont'd.) 

unit number field • 2-9 
PID (process identification number) 
and process context • 3-2 
Positional qualifier 
definition* 1-12 
rules for entering* 1-13 

PREVIOUS WINDOW command (EVE) *8-9, 8-35 
PRINT command (DCL) *2-19 
Print job *2-18 
delaying *2-19 

list of DCL commands to use with *2-19 
obtaining multiple copies of *2-19 
priorities *2-18 
Print queue 

and print job execution *2-18 
controlling *2-19 
definition *2-18 
generic *2-18 
terminal *2-18 

Privileged command image* 1-20 
Process *3-1 

See also Subprocess 
and job tree *3-3, 3-5 
creating *3-1 
definition *3-1 
detached *7-3 
types of *3-1 
Process characteristics 

lexical functions used to save and restore* 
6-34 

obtained from UAF* 1-3 
Process context *3-1 

list of characteristics • 3-2 
Process directory logical name table 
list of default contents of *4-9 
Process identification number 
See PID 

Process logical name 
in a job tree *4-5 
Process logical name table 
definition *4-5 

list of default contents in • 4-6 
logical name for *4-5 
Process-permanent logical names 
list of *4-17 
Process privilege 
and file access *2-1 
and process context *3-3 
Process rights identifier 
and process context *3-3 
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Program *3-1 
as batch job • 3-8 
command image • 3-4 
definition • 3-3 
executing • 3-3 

across network • 3-4 
noncommand image *3-4 
Prompt 

system in a command line* 1-11 
Protection *7-1 

access-control-list-based • 7-6 
default *7-5, 7-10 
device *7-12 
directory *7-11 
disk volume *7-11 
displaying file *7-12 
file • 7—5, 7-9 
format for object • 7-4 
nonfile device *7-12 
of copied files *7-5 
of mail file *7-11 
user data and devices *7-5 
user-identification-code-based • 7-2 
Protection mask • 7-4 
Proxy login account 
definition *2-12 
PURGE command (DCL)*2-17 


Q 


Qualifier 

abbreviating* 1-12 
command* 1-12 
default values* 1-13 
definition* 1-9 
format* 1-13 
in DCL command line* 1-8 
parameter* 1-13 
positional* 1-13 
rules for entering* 1-12 
types of* 1-12, 1-13 
Qualifier values 

date and time formats* 1-14 
rules for entering* 1-14 
types of* 1-14 
Queue 

batch • 3-8 
generic *2-18 
print *2-18 


Queue (cont'd.) 

terminal *2-18 
QUIT command (EDT) • 8-48 
QUIT command (EVE) *8-3 


R 


Radix 

specifying in symbol assignment *5-8 
Read access category 
definition • 7-4 

READ command (DCL) *5-5, 6-9, 6-15 
READ command (MAIL) • 1 -30 to 1-31 
RECALL command (DCL)* 1-21 
Recalling commands* 1-21 to 1-22 
Record 

deleting in command procedure *6-17 
modifying in command procedure *6-16 
writing from command procedure *6-17 
Record format • 2-4 
Record oriented device 
definition • 2-8 
Record sort* 1-37 
/RECOVER qualifier *8-23 
Relative file • 2-4 
Remote node 

copying files to local node from *2-14 
definition* 1-3 
displaying files on *2-11 
printing file on *2-19 
REMOVE command (EVE) *8-15 
RENAME command (DCL) *2-17 
REPEAT command (EVE) *8-7 
REPLACE command (EVE) • 8-20 
RESET command (EDT) *8-65 
$RESTART global symbol *5-4 
RESTORE CHARACTER command (EVE) *8-13 
RESTORE command (EVE) *8-13 
RESTORE LINE command (EVE) *8-13 
RESTORE WORD command (EVE) *8-13 
RETURN command (DCL) *6-25 
RETURN key* 1-17, 1-19 
Right arrow key 

moving cursor with* 1-18 
RUN (Image) command (DCL) *3-4 
RUN (Process) command (DCL) *3-1 
Running head 

adjusting with DSR*9-13, 9-16 
Runoff 
See DSR 
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RUNOFF command (DCL) *9-17 


s 


SAVE EXTENDED EVE command (EVE) *8-39, 
8-43 

SEARCH command (MAIL)* 1-31 
Search list 

definition *4-15 
example *4-15 
in a file specification *4-15 
translation *4-15 
Search order 

for logical name translation *4-11 
Search string *8-17 
SECT command (EDT) *8-57 
Section file 

and initialization file • 8-44 
default location of *8-43 
saving command definitions and learn 
sequences in* 8-43 
SELECT command (EDT) • 8-62 
SELECT command (EVE) *8-15 
SELECT command (MAIL)* 1-33 
SEND command (MAIL)* 1-28 
SEND/EDIT command (MAIL)* 1-35 
Sequential file • 2-4 

and Sort/Merge Utility* 1-41 
SET ACL command (DCL)*7-13, 7-14 
SET CONTROL=Y command (DCL)*6-32 
SET CURSOR BOUND command (EVE) *8-9 
SET CURSOR FREE command (EVE) • 8-9 
SET DEFAULT command (DCL)*2-22, 2-23 
SET EDITOR command (MAIL)* 1-35 
SET ENTITY command (EDT) • 8-72 
SET FIND command (EVE) *8-19 
SET GOLD KEY command (EVE) *8-41 
SET HOST command (DCL) • 1-3 
SET LEFT MARGIN command (EVE) *8-26, 8-36 
SET LINES command (EDT) *8-72 
SET MESSAGE command (DCL)* 1-20 
SET MODE command (EDT) • 8-73 
SET NOGOLD KEY command (EVE) *8-43 
SET NOWRAP command (EVE) *8-36 
SET NUMBERS command (EDT) • 8-62 
SET ON command (DCL) *6-30, 6-31 
SET PASSWORD command (DCL)* 1-2 
SET PROTECTION command (DCL) *7-10 
SET PROTECTION/DEVICE command (DCL) • 7-3 


SET QUIET command (EDT) • 8-73 

SET RIGHT MARGIN command (EVE) *8-27, 

8-36 

SET SCREEN command (EDT) *8-72 

SET SEARCH command (EDT) *8-63, 8-65 

SET SYMBOL command (DCL) • 5-5 

SET SYMBOL/SCOPE command (DCL) • 5-5 

SET TABS command (EVE) *8-36 

SET TERMINAL command (DCL)* 1-23, 3-6 

SET TRUNCATE command (EDT) *8-72 

SET UIC command (DCL) • 7-3 

SET VERIFY command (DCL) *6-28 

SET WIDTH command (EVE) *8-28, 8-36 

SET WRAP command (EDT) *8-67, 8-72 

SET WRAP command (EVE) *8-36 

SSEVERITY global symbol *5-4 

Shareable tables 

group logical name table *4-7 
system logical name table *4-7 
SHIFT LEFT command (EVE) • 8-28, 8-36 
SHIFT RIGHT command (EVE) *8-28, 8-36 
SHOW ACL command (DCL) *7-12 
SHOW BUFFER command (EDT) • 8-70 
SHOW BUFFERS command (EVE) *8-31, 8-32 
SHOW command (EVE) • 8-31 
SHOW DEFAULT command (DCL) *2-22 
SHOW DEVICES command (DCL) *7-12 
SHOW ENTRY command (DCL) *2-18, 3-8 
SHOW KEY command (DCL)* 1-26 
SHOW LOGICAL command (DCL) *4-4 
See also SHOW TRANSLATION command 
and logical name access mode *4-13 
and logical name table structure • 4-9 
SHOW PROCESS command (DCL) *3-2, 7-12 
SHOW PROTECTION command (DCL) *7-12 
SHOW QUEUE command (DCL) *2-18 
SHOW SYMBOL command (DCL) *5-5, 6-29 
SHOW SYSTEM BUFFERS command (EVE) *8-31 
SHOW TRANSLATION command (DCL) *4-4 
See also SHOW LOGICAL command 
SHRINK WINDOW command (EVE) *8-35 
Sort 

batch job* 1-41 
character data* 1-39 
collating sequence* 1-39 
indexed output file* 1-41 
key*1-38 
output file* 1-41 
single key* 1-38 
terminal input* 1-40 
types of* 1-37 to 1-39 
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SORT command (DCL)* 1-37, 1-38 
See also Sort/Merge Utility 
Sort/Merge Utility (SORT/MERGE) 

See also Sort 
collating sequences 
ASCII* 1-39 
EBCDIC* 1-39 

entering records from terminal with* 1-40 
invoking* 1-37 
merging files with* 1-42 
sorting noncharacter data files with* 1-40 
sorting records with* 1-37 
SPAWN command (DCL)* 1-21, 3-5 
SPAWN command (EVE) *8-46 
SPLIT WINDOW command (EVE) *8-35 
START OF LINE command (EVE) *8-9 
Startup file 
EDT *8-71 

SSTATUS global symbol *5-4 
STOP command (DCL)* 1-21, 6-4, 6-32 
STORE TEXT command (EVE) *8-15 
Subdirectory *2-1 
creating *2-21 
definition • 2-6 

setting default to another *2-22 
syntax *2-7 

SUBMIT command (DCL) *3-8 
Subprocess *3-1 

and job tree*3-3, 3-5 

and process identification number *3-7 

context • 3-7 

creating • 3-5 

definition • 3-5 

deleting *3-6 

exiting from • 3-6 

SUBROUTINE command (DCL) *6-26 
SUBSTITUTE command (EDT) *8-64 
Substring replacement*5-16 
Suspending terminal display* 1-23 
Switchhook character (%)• 1-36 
Symbol 

abbreviating • 5-4 
as another symbol *5-10 
as foreign command* 1-7, 5-1 
assignment *5-2 
character string • 5-2 
controlling access to *5-5 
creating • 5-2 

defined as a lexical function • 5-9 
defining in command procedure *6-9 
definition* 1-23, 5-1 


Symbol (cont'd.) 
deleting *5-5 
displaying *5-5 

in command procedure *6-12 
evaluation *5-3 
global *5-3, 5-6 

indicating a numeric value *5-3, 5-8 

list of DCL commands to use with *5-5 

local *5-2, 5-5 

logical data *5-10 

numeric overlay with *5-17 

passing to a command procedure *6-7 

precedence *5-3 

preventing assignment in subprocesses *3-8 
scope *5-5 
substitution • 5-6 
automatic • 5-6 
forced • 5-6 
order of *5-6 

substring replacement with *5-16 
symbol table search order *5-5 
used as variable *5-2 
used in expressions *5-7 to 5-8, 

5-11 to 5-19 
uses of *5-1 to 5-2 
Symbol table 

See Local symbol table, Global symbol table 
SYS$BATCH • 3-8 
SYS$COMMAND 
redefining *4-19 
SYS$ERROR 

redefining *4-19 
SYSSINPUT 

redefining *4-18 

in command procedure *6-10 
SYS$OUTPUT 
redefining *4-18 
SYS$PRINT • 2-18 

and batch job log files *3-9 
System directory logical name table 
list of default contents of *4-10 
System logical name table 
definition *4-7 

list of default contents of *4-7 
logical name for *4-7 
System ownership category *7-3 
System-permanent logical name *4-20 
SYSUAF.DAT • 7-1 
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T 


TAB key* 1-18 
Table of contents 

producing with DSR •9-17 
Tag sort* 1-39 
Terminal 
display 

stopping and starting • 1-19, 1-23 
I/O 

in command procedure *6-10, 6-12 
protection *7-12 
Terminal queue 
definition* 2-18 
Text formatting 
with DSR *9-1 
Time 

See also Absolute time 
See also Combination time 
See also Delta time 

specifying absolute and delta date and time 
combinations* 1-16 
specifying absolute date and time* 1-15 
specifying delta date and time* 1-16 
TOP command (EDT)*8-57 
TOP command (EVE) *8-9 
Top level directory file *2-1, 2-6 
TPU command (EVE) *8-45 
TPU editor 

as default MAIL editor* 1-35 
TWO WINDOWS command (EVE) *8-35 
TYPE command (DCL)*6-12 
and wildcard characters *2-15 
displaying files with *2-15 
executing command procedure on remote node 
with • 6-2 


UIC (user identification code) 
alphanumeric *7-2 
and process context • 3-3 
default protection *7-10 
member component • 7-3 
numeric *7-2 
object *7-3 
process *7-3 
protection • 7-2 
UND C command (EDT) • 8-59 
UNDEFINE KEY command (EVE) *8-40 
UND L command (EDT) *8-61 
UND W command (EDT) *8-60 
Unit number field 
default value *2-10 
definition • 2-9 
Unit record device 
definition • 2-8 
Up arrow key 

recalling commands with* 1-18, 1-21 
UPPERCASE command (EVE) *8-30 
UPPERCASE WORD command (EVE) *8-36 
User account 
in UAF*7-1 
User authorization file 
See UAF 

User file directory 
See UFD 

User identification code 
See UIC 

/USER_MODE qualifier 

redefining SYS$INPUT with *4-18 
redefining SYS$OUTPUT with *4-18 
Utility 

definition* 1-26 
types of* 1-26 


u 


UAF (user authorization file) 
and login procedure* 1-1 
and process characteristics* 1-3, 7-1 
and the Authorize Utility *7-1 
definition *7-1 
UFD (user file directory) *2-1 
See also Directory structure 
contents of *2-6 
location of *2-8 



Value 

definition* 1-9 
in DCL command line* 1-8 
Volume 

See also Disk 
definition • 2-9 
Volume set 

definition • 2-9 
disk *2-9 
tape *2-9 
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White space 

finding in EVE *8-19 
Wildcard character 
asterisk (*) • 2— 14 

duplicating directory structure with*2-25 
ellipsis (...)• 2-23 to 2-24 
hyphen (-)*2-24 to 2-25 
in directory specifications • 2-8 
in EVE file name *8-2 

in file specifications containing logical names* 
4-15 

in search string *8-18 


percent sign (%) • 2— 15 
WILDCARD FIND command (EVE) *8-18 
Window 

definition • 8-2 

EVE commands for using *8-35 
Word 

definition *5-1 

WORD command (EDT)*8-55 
World ownership category *7-4 
WPS keypad option 
using in EVE *8-23 
Write access category 
definition • 7-4 

WRITE command (DCL)*6-12 / 6-13 

WRITE command (EDT)*8-69 

WRITE FILE command (EVE) *8-24, 8-31, 8-34 
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